{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_b89vq2x5yh4a","handle":"codebase-mcp-2","url":"https://wellknown.network/agents/codebase-mcp-2","links":{"self":"https://wellknown.network/agents/codebase-mcp-2/record.json","html":"https://wellknown.network/agents/codebase-mcp-2","markdown":"https://wellknown.network/agents/codebase-mcp-2/record.md","api":"https://wellknown.network/api/v1/agents/codebase-mcp-2","status":"https://wellknown.network/api/v1/agents/codebase-mcp-2/status","claim":"https://wellknown.network/agents/codebase-mcp-2/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/codebase-mcp-2/claim.json","badge":"https://wellknown.network/agents/codebase-mcp-2/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/codebase-mcp-2/history","tools":"https://wellknown.network/api/v1/agents/codebase-mcp-2/tools"},"ard":{"identifier":"urn:air::server:codebase-mcp-2","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"codebase-mcp","summary":"Persistent, portable codebase intelligence MCP server with incremental indexing and decision memory","description":"# codebase-mcp\n\nA local MCP server that gives any AI agent or IDE a persistent, structured understanding of your codebase. It indexes your project once, stores everything in a local SQLite database, and answers structural questions instantly without the agent having to read any files.\n\n---\n\n## The problem it solves\n\nEvery time you start a new session in Claude Code, Cursor, Cline, or any other AI tool, the agent has to re-read your files to understand the codebase. On large projects this burns thousands of tokens just on orientation, and the agent still only sees a shallow surface. It cannot answer questions like \"what calls this function\", \"what changed since yesterday\", or \"what decisions were made and why\" without reading everything again.\n\ncodebase-mcp solves this by:\n\n- Parsing your code once with tree-sitter (Python, TypeScript, JavaScript, Go, Rust, and 50+ more languages)\n- Storing every function, class, method, import, and call site in a local database\n- Keeping that database up to date incrementally (only changed files are re-parsed)\n- Exposing a set of MCP tools so any agent can query the structure without reading files\n- Persisting architectural decisions, notes, and session history across every agent and IDE you use\n\n---\n\n## How it is different from standard approaches\n\n| | Standard approach | codebase-mcp |\n|---|---|---|\n| Codebase understanding | Agent reads files in context window | Pre-indexed, queried via tool calls |\n| Cost per session | Hundreds to thousands of tokens on orientation | Near zero — index is already built |\n| Call graph | Not available | Full caller/callee resolution with 3 strategies |\n| Decisions and notes | Lost when context resets | Stored in database, searchable forever |\n| Switching agents/IDEs | Start over from scratch | Export once, import anywhere |\n| Multi-language | Depends on the agent | 50+ languages via tree-sitter |\n| Incremental updates | Full re-read every time | SHA256-based, only changed files reparsed |\n\nThe cor…","publisher":null,"homepage":null,"repository":null,"version":"0.1.2","license":"MIT","protocols":["mcp"],"tags":["agent","ai","codebase","indexer","mcp","tree-sitter"],"pricing":null,"endpoints":[{"url":"pypi:codebase-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"}},"derived":{"capabilities":[{"slug":"data.database","name":"Databases","confidence":1,"provenance":"derived"}],"categories":["data"],"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":"codebase-mcp","registry":"pypi","observedAt":"2026-11-09T02:25:40.732Z","publishedAt":"2026-03-31T11:15:03.093813Z","latestVersion":"0.1.2"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"codebase-mcp","url":"https://pypi.org/project/codebase-mcp/","firstSeenAt":"2026-09-09T11:31:29.209Z","fetchedAt":"2026-11-09T02:24:13.902Z","normalizedAt":"2026-11-09T02:24:13.902Z"}]},"firstSeenAt":"2026-09-09T11:31:29.209Z","updatedAt":"2026-11-09T02:25:40.732Z"}