
Gortex MCP Server: Setup for Claude Code, Cursor and Other Apps
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.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Client does not support this transport.
Client does not support this transport.
Install Gortex MCP
Claude Code
- 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
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 ·
exploreSearches 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 ·
searchReads 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 ·
readShows 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 ·
relationsFollows 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 ·
traceRuns 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 ·
analyzeAsks 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 ·
askChecks 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 ·
changeEdits 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 ·
editRenames, 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 ·
refactorBuilds 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 ·
reviewPosts 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_reviewLists, scores and triages open pull requests
Reads pull requests from your code host and works out blast radius, risk, merge conflicts between PRs and suggested reviewers.
Try: “Which open pull requests are riskiest to merge?”
Network ·
prReads saved notes, memories and notebooks about the project
Looks up durable notes the assistant or you saved earlier, including memories, notes and notebooks, and onboarding summaries.
Try: “What did we note earlier about the payments module?”
Read ·
recallSaves notes and memories so later sessions can use them
Stores or edits memories, notes and notebooks, and records acknowledged risks or suppressed findings, which Gortex keeps on your machine.
Try: “Remember that the billing module must not call the legacy API.”
Write ·
rememberShows which repositories, projects and index state Gortex has
Reports tracked repositories, active project, scopes and index status, and the state of the daemon proxy. Read only.
Try: “Which repos is Gortex tracking right now?”
Read ·
workspaceTracks or untracks repos, re-indexes and changes saved scopes
Changes durable workspace state: add or remove repositories, rebuild the index, save or delete scopes, and run enrichment passes such as blame and coverage that store results.
Try: “Track my ~/projects/api repo and reindex it.”
Delete ·
workspace_adminTries edits in a temporary copy without touching files on disk
Creates in-memory overlay sessions so the assistant can test changes against the graph before anything is written. Nothing reaches disk from this tool.
Try: “Open a temporary overlay with my proposed change and check what breaks.”
Write ·
overlayChanges settings for the current chat session
Adjusts connection-lifetime state such as planning mode, workflows, navigation cursor and event subscriptions.
Try: “Subscribe to diagnostics for this session.”
Write ·
sessionSearches or slices large earlier tool outputs
Lets the assistant grep, slice or export a big response that Gortex buffered, instead of re-running the query.
Try: “Show lines 200 to 260 of that last result.”
Read ·
responseUsed by the assistant behind the scenes
Lists the operations each Gortex tool supports
Returns the available tools and operations, or the exact input format of one operation, so the assistant calls the others correctly.
Try: “Which operations does the search tool support?”
Read ·
capabilities
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
- Read your data
- Create and change things
- Delete things
- Read-only modeHow to turn it on
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
2 known advisories, all fixed in a newer version.
- Gortex mcp --server HTTP API Missing Origin Validation Enables Cross-Origin Arbitrary File Write and RCEhigh · Fixed in 0.64.8 · GHSA-2hvx-wq2g-73xw
- Arbitrary file write / repo-confinement escape in write_file / edit_file / move_inline MCP tools → code executionhigh · Fixed in 0.55.0 · GHSA-w42c-h7hr-f67p
3 other advisories are about the wider gortex project, not this MCP server. See them on GitHub
Technical details
| Turning on read-only | Add --tools nav (read-only navigation) or --tools readonly (everything except the mutating tools) to the gortex mcp command, or set GORTEX_TOOLS. |
|---|---|
| Talks to | Your code host, only for the pull request tools. Your configured AI provider, only for the ask tool |
| Sign-in and keys | No 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
Sources
Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.
Show all 5Hide
- github.com · github.com
- github.com · github.com
- github.com · github.com
- github.com · github.com
- github.com · github.com