{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_fd3fpr4m6fn5","handle":"codecompass-mcp","url":"https://wellknown.network/agents/codecompass-mcp","links":{"self":"https://wellknown.network/agents/codecompass-mcp/record.json","html":"https://wellknown.network/agents/codecompass-mcp","markdown":"https://wellknown.network/agents/codecompass-mcp/record.md","api":"https://wellknown.network/api/v1/agents/codecompass-mcp","status":"https://wellknown.network/api/v1/agents/codecompass-mcp/status","claim":"https://wellknown.network/agents/codecompass-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/codecompass-mcp/claim.json","badge":"https://wellknown.network/agents/codecompass-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/codecompass-mcp/history","tools":"https://wellknown.network/api/v1/agents/codecompass-mcp/tools"},"ard":{"identifier":"urn:air::server:codecompass-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"codecompass-mcp","summary":"Structural code context for AI coding agents — a local code knowledge graph for blast radius, impact, deps, dead code, and flow tracing","description":"# CodeCompass\n\nA local code knowledge graph that gives AI agents a map of your codebase — so they navigate by structure instead of grepping blind, and know what's connected before they edit. One graph query replaces dozens of file opens: fewer tokens, less compute, and every answer comes with a verifiable `file:line`. And it compounds — descriptions, edges, and corrections agents write back survive re-indexes and persist across sessions, so each task starts from everything every previous session learned instead of from zero.\n\nNo cloud. No API keys for core queries. One JSON graph per repo. Python, JavaScript/TypeScript, PHP, HTML/CSS.\n\n---\n\n## Why it's faster\n\nAI agents read files one at a time and grep to find their way. On a real task that means opening candidate after candidate to answer \"who calls this?\" or \"what breaks if I change this?\" CodeCompass answers those from a precomputed graph, so the agent reads *only the code it actually needs*.\n\nWe benchmarked it against traditional grep/read on six standard tasks (impact, blast radius, dead code, flow trace, find-and-edit, feature scoping) across four real repos, measuring **tokens to a verified answer** — the query output *plus* the code still read to trust it.\n\n![Tokens to a verified answer: CodeCompass vs grep/read across Python, PHP, and JavaScript](docs/benchmark-chart.svg)\n\nCodeCompass wins every relational and discovery task; grep only holds even on a\nplain textual find of a known string. The advantage grows with codebase size and\nname collisions. Full breakdown, per-task numbers, and honest limitations in\n**[docs/benchmark-results.md](docs/benchmark-results.md)**.\n\n---\n\n## The workflow\n\nThe graph turns navigation into a cheap, deterministic loop:\n\n**discover → trace → read → edit**\n\n1. **Discover** — find the symbols you care about without opening files:\n\n   | You have… | Use |\n   |---|---|\n   | a concept, name, or pattern | `grep` (regex over graph entities) |\n   | an idea, not a name (\"where does cachi…","publisher":{"name":"CodeCompass contributors","url":null},"homepage":null,"repository":null,"version":"7.2.0","license":"MIT","protocols":["mcp"],"tags":["ai","code-graph","llm","coding-agent","tree-sitter","mcp"],"pricing":null,"endpoints":[{"url":"pypi:codecompass-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","summary":"pypi","version":"pypi","description":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"code.generation","name":"Code Generation","confidence":1,"provenance":"derived"},{"slug":"knowledge.knowledge-graph","name":"Knowledge Graphs","confidence":1,"provenance":"derived"},{"slug":"dev.filesystem","name":"Filesystem","confidence":0.802,"provenance":"derived"}],"categories":["code","dev","knowledge"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"codecompass-mcp","registry":"pypi","observedAt":"2026-09-15T11:23:10.619Z","publishedAt":"2026-07-25T20:20:24.009369Z","latestVersion":"7.2.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"codecompass-mcp","url":"https://pypi.org/project/codecompass-mcp/","firstSeenAt":"2026-09-09T11:31:30.429Z","fetchedAt":"2026-09-15T11:22:33.479Z","normalizedAt":"2026-09-15T11:22:33.479Z"}]},"firstSeenAt":"2026-09-09T11:31:30.429Z","updatedAt":"2026-09-15T11:23:10.619Z"}