PlugWiki
Gortex logo

Gortex MCP Server: Setup for Claude Code, Cursor and Other Apps

CommunityLocal

Lets Claude, Cursor and other coding assistants search, trace and edit your code through a local graph of your projects.

Gortex indexes your code into a graph and gives your assistant tools to find symbols, follow calls, check what a change affects, and edit files. It runs on your machine as a single downloaded program, with no account or API key. By default the assistant sees 21 tools, and they include editing, refactoring and deleting code. Set up read-only first if you only want it to look around.

Good for

  • Developers who want assistants to find code without reading whole files
  • Teams working across several repositories that need cross-repo call and API links
  • Reviewers who want pull request risk and blast radius before merging
  • People hitting context limits on large codebases

Works in

12 should work

Tap an app to see how to set it up and any known problems.

Install Gortex MCP

Claude Code

  1. 1

    Copy this prompt.

    Add the Gortex MCP server to Claude Code. Run this command:
    
    gortex install
    
    Then check that it loaded and tell me if I need to sign in or restart.
  2. 2

    Paste it into Claude Code. It shows the change and asks before running it.

Requires Gortex binary installed and on PATH.

Read-only mode: Add `--tools nav` after `mcp` in the args (read-only navigation), or set the environment variable GORTEX_TOOLS to nav.

First install the program: curl -fsSL https://get.gortex.dev | sh on macOS and Linux, or irm https://get.gortex.dev/install.ps1 | iex in PowerShell. Homebrew users can run brew install zzet/tap/gortex. The easiest route is gortex install, which writes the config for each assistant it finds, adds hooks and skills, and then gortex init in each project. The manual config below only adds the server. Gortex indexes projects you track with gortex track <path>.

From the project README. Source.

Tools

  • Finds the code that matters for a task in your indexed project

    Takes a task or question and returns the files, symbols and surrounding context an assistant needs, built from the code graph. It can also outline a repo or plan the next steps.

    Try: “Find where login sessions are created and what code depends on it.”

    Read · explore

  • Searches code by symbol name, text, file name or syntax pattern

    Looks up functions and classes by name, runs literal or regex text search, finds files by name and matches syntax patterns, all against the index of your project.

    Try: “Find every function named parseConfig.”

    Read · search

  • Reads a file, a single function or several symbols at once

    Returns file contents, one symbol with its signature and source, a file summary, or the context needed before an edit. Reads one target per call.

    Try: “Show me the source of the handleRequest function.”

    Files · read

  • Shows who calls a function, what it depends on and what implements it

    Answers fixed questions about how code connects: usages, callers, dependencies, dependents, implementations, overrides and class hierarchies.

    Try: “Who calls validateToken, and what would break if I change it?”

    Read · relations

  • Follows call chains and data flow through the code

    Walks forward call chains, finds paths between two symbols, and follows data flow or tainted input through the graph for deeper investigations.

    Try: “Trace how user input reaches the SQL query in the orders handler.”

    Read · trace

  • Runs checks like hotspots, dead code, TODOs and architecture summaries

    Runs read-only graph analyses over your project, such as heavily changed hotspots, unused code, API contracts and architecture layers. Analyses that save results are kept out of this tool.

    Try: “Which parts of this repo are dead code?”

    Read · analyze

  • Asks a research agent that uses the code graph to answer an open question

    Hands an open-ended question to an agent that drives Gortex's own search and graph tools and returns one answer. It needs an AI provider set up in Gortex first, and is off until you do.

    Try: “Explain how requests move from the API layer to the database.”

    Network · ask

  • Checks the impact of a change before and after you make it

    Detects what changed, shows diagnostics and blast radius, previews and simulates an edit, and picks the tests to run. It does not apply changes.

    Try: “What is the impact of renaming UserService, and which tests should I run?”

    Read · change

  • Edits files and symbols, and can move or delete whole files

    Applies text edits to files or symbols, writes new files, batches several edits, and can move or delete whole files. It also generates docs, wiki and graph exports. Output paths are limited to indexed repositories when an assistant calls it.

    Try: “Replace the old timeout value in server.go with 30 seconds.”

    Delete · edit

  • Renames, moves, inlines or deletes code with language-aware changes

    Applies refactors that follow the code structure, including rename, move, inline and delete, and applies editor code actions and fix-alls across files.

    Try: “Rename the function fetchUser to loadUser everywhere it is used.”

    Delete · refactor

  • Builds a code review with findings and context for a diff

    Produces review packs and critiques from your diff, with surrounding code, sibling files and questions to answer. It does not post anything.

    Try: “Review my current changes and list risks.”

    Network · review

  • Posts review comments to GitHub or another code host

    Publishes a prepared review to a pull request on your code host. This is the one tool that writes outside your machine.

    Try: “Post the review findings to pull request 42.”

    Write · publish_review

From the official docs

Permissions

high risk · 7 things to watch · 2 advisories

High risk

The assistant can read your whole indexed codebase and, by default, edit, rename and delete code. Start with a read-only preset and a clean git branch.

What it can do

Watch out for

  • It can edit, rename and delete your code

    The edit and refactor tools write files, and can move or delete whole files or symbols. Run it on a clean git branch, or start it read-only. github.com

  • The review tool can post to GitHub

    The publish_review tool writes review comments to a pull request on your code host. Review the text before the assistant sends it. github.com

  • The installer changes your whole machine

    gortex install edits your assistants' configs, adds hooks and skills under folders like ~/.claude, and the curl script puts a program on your PATH. Read what it writes first, or add the server by hand. github.com

  • A background program keeps running

    The daemon holds the index of your tracked repositories in memory and on disk. Its optional HTTP port binds to 127.0.0.1 by default, and the program refuses a non-local address without an auth token. github.com

  • Research tool can send code to an AI provider

    If you configure an AI provider, the ask tool sends your questions and code snippets to it. It is off until you set one up. github.com

  • Tool output is screened for prompt injection

    Gortex scans arguments and results for injection patterns and adds a warning note; it never blocks the call. github.com

  • Telemetry is off by default

    Anonymous tool counts are sent only if you turn them on with gortex telemetry on. github.com

Security advisories

Technical details
Turning on read-onlyAdd --tools nav (read-only navigation) or --tools readonly (everything except the mutating tools) to the gortex mcp command, or set GORTEX_TOOLS.
Talks toYour code host, only for the pull request tools. Your configured AI provider, only for the ask tool
Sign-in and keysNo account. The index and saved notes stay under ~/.gortex on your machine.

Questions

Is Gortex official?

No. It is a community project by Andrey Kumanyaev, open source under Apache 2.0, and not made by Anthropic, OpenAI or any editor vendor.

Does Gortex need an API key or account?

No. It runs locally with no sign-in. You only need a key if you turn on the ask tool with an AI provider, or the pull request tools with your code host.

Can I run Gortex read-only?

Yes. Add --tools nav to the gortex mcp command for read-only navigation, or --tools readonly for everything except the mutating tools. The pull request and review tools stay in readonly, and some of them contact your code host.

How many tools does it have?

MCP clients get a compact set of 21 by default. The full surface is about 180 tools, selected with the full preset, so the exact count depends on the preset you choose.

Which assistants does it work with?

The docs list 19 coding agents, including Claude Code, Cursor, Codex, Gemini CLI, VS Code, Windsurf, Cline and Zed. gortex install writes the config for the ones it finds.

Does it send my code anywhere?

Not by default. Indexing and search run on your machine. Code leaves only if you configure an AI provider for the ask tool, or use the pull request tools with your code host.

Does it run as a server I have to keep running?

It starts a background daemon on your computer that shares one index across your assistants. gortex mcp connects to it over standard input and output.

Information

updated Nov 2, 2026

Publisher
Community
Transport
stdio
Auth
None
License
Apache-2.0
Last commit
Oct 31, 2026
Open issues
181

WebsiteGitHubChangelogIssues

Sources

Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.

Show all 5
  1. github.com · github.com
  2. github.com · github.com
  3. github.com · github.com
  4. github.com · github.com
  5. github.com · github.com

Facts from the official MCP registry, GitHub, npm, PyPI and the Docker catalog. Updated Nov 2, 2026.