Codesurface
Expose a compact, indexed public API map of your repo so the agent stops guessing exports and signatures.
Overview
CodeSurface is a Build-phase MCP server that indexes your repository’s public API and serves compact responses to coding agents.
What is this MCP server?
- PyPI package `codesurface` v0.8.0, runnable via uvx with stdio MCP
- Indexes the codebase public API into compact MCP tool responses
- Reduces token-heavy file dumps when the agent only needs surface area
- Open-source repo on GitHub under Codeturion/codesurface
- MCP server version 0.8.0
- PyPI identifier codesurface with uvx runtime hint
- GitHub repository Codeturion/codesurface
Community signal: 22 GitHub stars.
What problem does it solve?
Large repos waste context and invite wrong guesses when the assistant lacks a faithful map of what is actually public.
Who is it for?
Solo devs on growing codebases who want smaller, accurate API context in Claude Code or Cursor.
Skip if: Greenfield one-file scripts or teams that need runtime debugging and logs rather than API surface docs.
What do I get? / Deliverables
After registration, your agent can pull indexed public API summaries through MCP instead of scanning entire trees.
- Indexed public API view exposed via MCP tools
- Shorter agent context pulls for module and export discovery
- Repeatable stdio server hook for the active project
Recommended MCP Servers
Journey fit
API indexing is created while you build and document the codebase, but the same index speeds early prototypes and daily agent sessions. The server’s purpose is documentation-shaped—serving public API surfaces—not running your app backend.
How it compares
Local public-API indexer MCP, not hosted dependency analytics like CodeLogic.
Common Questions / FAQ
Who is codesurface for?
Builders maintaining libraries or services who want MCP clients to see an indexed public API without full-repo dumps.
When should I use codesurface?
Use it while building or documenting modules, or whenever the agent repeatedly misidentifies exports and package boundaries.
How do I add codesurface to my agent?
Install or run `codesurface` from PyPI (uvx), add a stdio MCP server entry in your client config, and aim it at the project root you want indexed.