Give Claude Code, Cursor, and Windsurf on-demand access to your codebase signatures. Zero npm install.
Easiest path
One command detects your editor config and wires everything up automatically.
.claude/settings.json and .cursor/mcp.json automatically, then adds the sigmap MCP server entry to each one it finds. Also installs a git post-commit hook and starts the file watcher.Manual config
Add the sigmap MCP server to your Claude Code settings file.
.claude/settings.json in your project root for project-level access, or ~/.claude/settings.json for global access across all projects. The absolute path in args must point to the actual gen-context.js file on disk.Manual config
Add sigmap to your Cursor MCP configuration file.
Combined setup
Stack both MCP servers for the two-layer context strategy — SigMap for always-on signatures, Repomix for deep ad-hoc sessions.
Reference
All tools are available on-demand — your AI agent calls only what it needs, keeping token costs low.
| Tool | What it does | Arg(s) | Example call |
|---|---|---|---|
| read_context | Returns signatures for the full codebase or a specific module path. Outputs ~50–500 tokens depending on scope. | module (optional string) | read_context(module="src/auth") |
| search_signatures | Case-insensitive keyword search across all extracted signatures. Returns matching lines grouped by file. | query (required string) | search_signatures(query="handleRequest") |
| get_map | Returns import graph, class hierarchy, or route table from PROJECT_MAP.md. Useful for understanding wiring without reading source. | type ("imports"|"classes"|"routes") | get_map(type="routes") |
| explain_file | Returns signatures, imports, and reverse callers for a single file. Best for understanding what a file does and who calls it. | path (required string) | explain_file(path="src/auth/service.ts") |
| list_modules | Returns a token-count table of top-level source directories. Use this first to decide which module to load. | none | list_modules() |
| create_checkpoint | Records session progress with a git state snapshot. Useful for marking stable points during long refactor sessions. | summary (required string) | create_checkpoint(summary="Added rate limiting") |
| get_routing | Returns the model tier hints table (fast / balanced / powerful per file) based on complexity scores. | none | get_routing() |
| query_context | Ranks all files by relevance to a free-text query using TF-IDF scoring. Returns a scored table of the top-K files with matching signatures. New in v2.3. | query (required string) topK (optional number, default 10) |
query_context(query="authentication flow") |
Cost reference
Approximate token consumption. Use list_modules() first and read_context(module=...) to stay efficient.
| Tool call | Approx. tokens |
|---|---|
| read_context() full codebase | 200–4,000 |
| read_context(module="src/auth") | 20–500 |
| search_signatures(query="login") | 10–200 |
| get_map(type="routes") | 50–800 |
| explain_file(path="...") | 30–400 |
| list_modules() | 20–100 |
Verification
Send a raw JSON-RPC request to confirm the server starts and returns all 8 tool definitions.
Staying current
The MCP server reads whatever context file is on disk. Keep that file up to date and every tool call reflects your latest code.
sigmap --watch in a terminal while you code. Every file save triggers an incremental regeneration. Best for active coding sessions.sigmap --setup once. It installs a .git/hooks/post-commit hook that regenerates context automatically on every commit. More reliable than the watcher across sleep/wake cycles.What's next