symbolhop
Provides language-server-backed C++ code intelligence, including go-to-definition, find-references, hover information, diagnostics, and file outlines via clangd.
Provides language-server-backed JavaScript code intelligence, including definitions, references, hover information, diagnostics, and file outlines via typescript-language-server.
Provides LSP-backed Lua navigation and diagnostics, including definitions, references, hover information, diagnostics, and file outlines via lua-language-server.
Provides LSP-backed Python navigation and diagnostics, including definitions, references, hover information, diagnostics, and file outlines via pyright.
Provides LSP-backed Ruby navigation and diagnostics when explicitly enabled, including definitions, references, hover information, diagnostics, and file outlines via ruby-lsp.
Provides LSP-backed Rust navigation and diagnostics, including definitions, references, hover information, diagnostics, and file outlines via rust-analyzer.
Provides LSP-backed Swift navigation and diagnostics, including definitions, references, hover information, diagnostics, and file outlines via sourcekit-lsp.
Provides language-server-backed TypeScript code intelligence, including definitions, references, hover information, diagnostics, and file outlines via typescript-language-server.
Provides LSP-backed Zig navigation and diagnostics when explicitly enabled, including definitions, references, hover information, diagnostics, and file outlines via zls.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Ask a terminal agent where a function is used, and it greps. It gets back every comment, log message, string and similarly named symbol along with the real uses, reads them all, and sometimes still guesses wrong. Editors stopped doing that decades ago: they ask a language server.
symbolhop lets the agent ask too. It starts the language server for the file's language (clangd, typescript-language-server, pyright, gopls, rust-analyzer and others), and answers five questions exactly, in one short line per result.
Measured on a made-up C project (rerun it yourself): finding the uses of count_entries returned 10 exact lines from lsp_references, against 59 to 77 lines from grep, 49 to 67 of which weren't uses. That's about 9 to 11 times fewer tokens, the best of three questions measured; the other two came out about 4 times and 2 to 3 times fewer. For a struct field named like local variables, grep returned 148 to 201 lines, 75 to 128 of them wrong; lsp_references returned the 73 real ones and missed none. The true uses were listed independently while the project was generated. Real projects will vary; the full table says how it was measured.
If it saves your agent some guessing, starring the repo helps other people find it.
The tools
Tool | What the agent gets |
| Where a symbol is defined: |
| Every use of it across the project, one line each, without comments, strings or other symbols with the same name |
| Its type, signature and documentation |
| The errors and warnings in a file as it is on disk now, right after the agent edits it |
| A file's outline: classes, functions and fields, with line numbers |
The agent names the symbol instead of counting columns: {"file": "src/main.c", "line": 14, "symbol": "parse_config"}.
Related MCP server: VSCode MCP
Set it up
You need Node 20 or later, and a language server for your project's language on your PATH. npx github:stanczykwyatt/symbolhop doctor shows which it finds.
Language | Server |
C, C++, Objective-C |
|
TypeScript, JavaScript |
|
Python |
|
Go |
|
Rust |
|
Swift |
|
Java, Ruby, Lua, Zig |
|
Then add it to your agent. It runs in the folder the agent starts it in; add --root /path/to/project to pin one. npx fetches it from GitHub the first time, which can take a few seconds; if your agent gives up on slow servers, npm install -g github:stanczykwyatt/symbolhop#v0.1.0 once and use symbolhop serve as the command.
By default it uses servers for C-family, TypeScript, Python, Go, Rust, Swift and Lua. Java, Ruby and Zig servers run the project's build files as soon as they start, so they're only used when you list them: serve --languages c,typescript,java. On Windows, servers installed with npm (typescript-language-server, pyright) don't start yet, because Node won't start .cmd files without a shell; clangd, gopls and rust-analyzer do.
Codex (~/.codex/config.toml):
[mcp_servers.symbolhop]
command = "npx"
args = ["-y", "github:stanczykwyatt/symbolhop#v0.1.0", "serve"]Claude Code:
claude mcp add symbolhop -- npx -y github:stanczykwyatt/symbolhop#v0.1.0 serveGemini CLI (~/.gemini/settings.json), and Cursor (.cursor/mcp.json) the same way:
{ "mcpServers": { "symbolhop": { "command": "npx", "args": ["-y", "github:stanczykwyatt/symbolhop#v0.1.0", "serve"] } } }Any other MCP client works the same: the command is npx -y github:stanczykwyatt/symbolhop#v0.1.0 serve.
From the terminal
The same answers, for you or for agents without MCP:
npx github:stanczykwyatt/symbolhop def src/main.c 14 parse_config
npx github:stanczykwyatt/symbolhop refs src/main.c 14 parse_config
npx github:stanczykwyatt/symbolhop diag src/report.cSafe to give an agent
Read-only. It asks for definitions, references, hovers, diagnostics and outlines, and nothing that edits a file. symbolhop itself never writes a file. clangd is started so it doesn't either: its index and precompiled headers stay in memory, and
.clangdfiles are ignored. Some other servers keep caches of their own (see SECURITY.md).Only your project. Every file must be inside the project folder, checked by its path before anything is looked up and again after following links, or the agent is told it's outside. Results outside it, like the standard library, are counted but not shown. A hover or a diagnostic can still quote a header outside the project that a project file includes.
Always current. Files the agent edited are sent to the language server again before the next question, so answers never come from old text.
No network, no dependencies. It's a few hundred lines of plain JavaScript using only Node's own modules. It starts language servers without a shell, from your PATH, and talks to them and the agent over stdio. CI checks for network and shell use.
Short output. At most 200 results per question unless asked, each line clipped, so a big project can't flood the agent.
The details are in SECURITY.md.
FAQ
Does Codex have this built in? Not yet: openai/codex#8745 asks for it. symbolhop works with Codex today through MCP, and keeps working with any agent if it ships.
Why not just let the agent grep? Grep is fine for text. For "where is this used", it returns comments, strings, log messages and every symbol with a similar name, and the agent pays tokens to read them and still has to guess. The measurements show how much.
Does it work in big projects? It asks your language server, so for most languages it's as complete as your editor. clangd and sourcekit-lsp only know the files they've been shown, so on the first references question symbolhop shows them up to 300 files of that language and waits until they've been read; past that, the answer says uses in other files may be missing.
Which agents has it been tried with? None yet, honestly: it was built and tested without one installed. The MCP server follows the 2025-11-25 protocol, its tests drive it over stdio the way an agent does, and it should work with anything that runs stdio MCP servers. Reports of how it works with your agent are very welcome in Discussions.
More free tools
Mac apps
Show Desktop: hide every window with one click or ⌃⇧D, then bring them all back exactly as they were.
Copy 2FA: copy 2FA codes from Mail, Messages or a built-in authenticator with one keyboard shortcut.
Who Stole My Focus: find out which app keeps jumping in front of your work.
AI Footprint: see what AI coding tools leave on your Mac, and what each update changed.
Memo Export: export your Voice Memos transcripts as Markdown, with the audio.
Podcast Export: export your Apple Podcasts shows as OPML, and your listening history.
Reading List Export: export your Safari Reading List as Markdown, bookmarks and CSV.
Unblock Eject: see what's keeping your disk from ejecting, and quit it politely.
Next Departures: your stop's next bus and train, live, in the menu bar.
Right Folder: Open and Save dialogs, in the right folder. A free Default Folder X alternative.
Tonecap: design your keyboard's sound, with no recordings, and hear it as you type.
SciLook: Quick Look for NWB, HDF5, MATLAB and NumPy files on your Mac.
Windows
Who Stole My Focus for Windows: the focus-thief finder as a Windows tray app (preview).
For coding agents
mulligan: undo for coding agents: snapshots at every prompt and tool call, for macOS and Linux.
For neuroscience data
brainhound: search and read public neuroscience data from your coding agent or terminal.
dropslice: open NWB, HDF5, MATLAB, NumPy and Zarr files in your browser.
On the web
Openfume: an open fragrance database you can search by notes and accords.
Next Departures fetches only the transit feeds you pick, brainhound reads only public neuroscience archives, and dropslice and Openfume are web pages that never upload your files. The rest have no internet access.
License
symbolhop is released under the MIT License and is provided as is, without warranty of any kind.
symbolhop is an independent project, not affiliated with OpenAI, Anthropic, Google, Anysphere or the makers of any language server. Codex is a trademark of OpenAI, Claude and Claude Code of Anthropic, PBC, Gemini of Google LLC, and Cursor of Anysphere, Inc. They're named only as what symbolhop works with. The code in the demo and the measurements is made up.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Code intelligence for coding agents: semantic, AST, graph, and full-text search. 279+ languages.
Shared memory for coding agents. Stop re-explaining your codebase every session.
Code intelligence for LLMs. Analyze, search, and retrieve code from any public git repository.
Stateless TS/JS compiler facts for agents: references, imports, impact. No repo index or OAuth.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceExposes type-aware code navigation and fast file search to AI agents via language servers, enabling definitions, references, symbols, and file lookup without reading entire codebases.2,580 npmMIT
- FlicenseNot gradedqualityAmaintenanceEnables AI coding agents to access real-time VSCode LSP diagnostics, type information, and code navigation without slow tsc/eslint checks, plus symbol renaming and file operations.-
- FlicenseNot gradedqualityAmaintenanceEnables AI coding agents to pull real-time LSP diagnostics, hover/definition/signature details, and symbol references with usage context from a running editor instance, replacing slow tsc/eslint/build runs. It also supports workspace-wide symbol renaming and opening files across multiple workspaces.-
- FlicenseNot gradedqualityAmaintenanceEnables AI coding agents to obtain real-time language-server diagnostics, type information, symbol definitions, references, and workspace-wide renames directly from open editor instances, avoiding slow external type and lint checks.-