{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_4mugwu6ugdgz","handle":"mcp-codebase-cartography","url":"https://wellknown.network/agents/mcp-codebase-cartography","links":{"self":"https://wellknown.network/agents/mcp-codebase-cartography/record.json","html":"https://wellknown.network/agents/mcp-codebase-cartography","markdown":"https://wellknown.network/agents/mcp-codebase-cartography/record.md","api":"https://wellknown.network/api/v1/agents/mcp-codebase-cartography","status":"https://wellknown.network/api/v1/agents/mcp-codebase-cartography/status","claim":"https://wellknown.network/agents/mcp-codebase-cartography/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/mcp-codebase-cartography/claim.json","badge":"https://wellknown.network/agents/mcp-codebase-cartography/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/mcp-codebase-cartography/history","tools":"https://wellknown.network/api/v1/agents/mcp-codebase-cartography/tools"},"ard":{"identifier":"urn:air::server:mcp-codebase-cartography","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"mcp-codebase-cartography","summary":"MCP server exposing AST-based tools and graph representations for efficiently exploring codebases.","description":"# `mcp-codebase-cartography`\n\nThis repository hosts the code for an MCP server exposing various tools aimed at efficiently exploring codebases without wasting tokens, using AST-based tools and graph representations.\n\n## Usage\n\nMCP configuration `mcp.json`:\n\n```json\n{\n  \"servers\": {\n    \"mcp-codebase-cartography\": {\n      \"type\": \"stdio\",\n      \"command\": \"uvx\",\n      \"args\": [\"mcp-codebase-cartography\", \"serve\"]\n    }\n  }\n}\n```\n\n### Building from source\n\nThe server ships a native extension (`python-bindings/`) built with\n[maturin](https://www.maturin.rs). From `python-bindings/`, build and install\nit into the active virtual environment:\n\n```sh\nmaturin develop --release\n```\n\nor build a wheel and install it:\n\n```sh\nmaturin build --release\npip install target/wheels/mcp_codebase_cartography-*.whl\n```\n\n### Installing from PyPI\n\nThe package is published to PyPI. Run it without installing via `uvx`, or\ninstall it with pip:\n\n```sh\nuvx mcp-codebase-cartography serve\npip install mcp-codebase-cartography\n```\n\n### Releasing\n\nReleases are cut from semver tags. The version lives in\n`python-bindings/Cargo.toml` (`package.version`) and is read dynamically by\n`pyproject.toml`.\n\n1. Bump `package.version` in `python-bindings/Cargo.toml`.\n2. Run the quality gates (`cargo clippy`, `cargo test`, `uvx ruff check\n   python-bindings`, `uv run pyrefly check python-bindings`).\n3. Commit and push a matching tag: `git tag v0.1.0 && git push origin v0.1.0`\n   (or `jj tag set v0.1.0`).\n\nPushing a `vMAJOR.MINOR.PATCH` tag triggers `.github/workflows/release.yml`,\nwhich builds the sdist and wheels, verifies the tag matches the package\nversion, publishes to PyPI, and creates a GitHub release with the artifacts.\n\nPrerequisite: PyPI [Trusted Publishing](https://docs.pypi.org/trusted-publishers/)\nmust be configured for the `pypi` GitHub environment so the workflow can\npublish without a token.\n\n### Repository root\n\nThe server indexes the repository root, discovered from the process working\ndirectory by…","publisher":null,"homepage":null,"repository":null,"version":"1.1.0","license":null,"protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:mcp-codebase-cartography","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","summary":"pypi","version":"pypi","description":"pypi"}},"derived":{"capabilities":[{"slug":"dev.version-control","name":"Version Control","confidence":1,"provenance":"derived"},{"slug":"dev.package-management","name":"Packages & Dependencies","confidence":0.768,"provenance":"derived"}],"categories":["dev"],"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":"mcp-codebase-cartography","registry":"pypi","observedAt":"2026-11-09T14:28:12.268Z","publishedAt":"2026-08-24T06:51:39.759306Z","latestVersion":"1.1.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"mcp-codebase-cartography","url":"https://pypi.org/project/mcp-codebase-cartography/","firstSeenAt":"2026-09-10T01:19:19.249Z","fetchedAt":"2026-11-09T14:27:18.164Z","normalizedAt":"2026-11-09T14:27:18.164Z"}]},"firstSeenAt":"2026-09-10T01:19:19.249Z","updatedAt":"2026-11-09T14:28:12.268Z"}