Codesurface MCP Server

MCP server that indexes your codebase's public API at startup and serves it via compact tool responses, saving tokens vs reading source files. Its 7 documented tools cluster into read & search, reindex, file, include. It runs locally over stdio via the published package.

People connecting coding agent tools to Claude, Cursor, VS Code, or another MCP client. The project is written in Python.

VERIFIED ACTIVE

LAST COMMIT 2026-07-28 · ★ 21 · #66 OF 194 MAINTAINED CODING AGENT · VERIFIED 2026-08-25

MIT · Python servers · how we verify → /methodology

01 · Install Codesurface

Claude Code

claude mcp add codeturion-codesurface -- uvx codesurface

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "codeturion-codesurface": {
      "command": "uvx",
      "args": [
        "codesurface"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

pypi package codesurface - check the name against the project README before installing (PyPI has no namespace ownership)

registry namespace io.github.Codeturion is GitHub-verified and matches the repo owner

03 · What Codesurface can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

An agent gets 7 documented tools across read & search, reindex, file, including search, get_signature, get_class, get_stats.

Capability map

Tools grouped from the project's README - what Codesurface lets an agent do.

read & search

4 tools - e.g. Find APIs by keyword; Exact signature by name or FQN; Full class reference card with all public members

search · get_signature · get_class · get_stats

Reindex

1 tool - e.g. Incremental index update (mtime-based)

reindex

File

1 tool - e.g. scope results to a directory prefix or exact file (e.g. "src/services/" or "src/services/MergeService.ts")

file_path

Include

1 tool - e.g. include test files in results (default false). Detects __tests__/, tests/, test/, .test., .spec., _test., test_

include_tests

Latest releases

v0.8.0 · 2026-04-28

Most of this release is contributed by @michael-howell-island. Big thanks! · New features · PathFilter with .codesurfaceignore, --exclude globs, and worktree/submodule skipping · file_path scoping on search…

v0.7.0 · 2026-02-28

What's New · Line numbers on every record · All API records now include line_start and line_end (1-indexed). Multi-line declarations span the full signature. This lets AI agents do targeted reads instead of reading…

v0.6.0 · 2026-02-27

What's New · Auto-reindex on query miss · When a query (search, get_signature, get_class) returns no results and the index may be stale, the server automatically runs an incremental reindex and retries. Uses a…

04 · Who maintains Codesurface

codesurface is maintained by codeturion. We track 3 MCP servers from codeturion - 3 actively maintained, 180 combined GitHub stars, oldest repo from Feb 2026. Full record: all servers from codeturion.

05 · Facts

repository: github.com/codeturion/codesurface
category: coding agent - ranked #66 of 194 actively-maintained coding agent servers as of 2026-08-25.
registry: io.github.Codeturion/codesurface (active, first published 2026-02-26 · 5 versions)
packages: pypi:codesurface

06 · Codesurface FAQ

Is Codesurface still maintained?

Yes - as of 2026-08-25, its last commit was 2026-07-28. We re-verify nightly.

What can Codesurface do?

An agent gets 7 documented tools across read & search, reindex, file, including search, get_signature, get_class, get_stats.

How do I install Codesurface?

Run `uvx codesurface`. You can also paste the ready-made client config above.

Does Codesurface run locally?

Yes - it's a stdio server: it runs on your machine (via uvx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Codesurface

Alternatives to Codesurface

Maintained coding agent servers if Codesurface isn't the fit.

Pairs well with

Servers that cover what Codesurface doesn't - only shown when the pairing reason fits the companion.

More coding agent MCP servers · Synaptic Code Intelligence · Claude Bridge · Continue With · Corralimited MCP Server · RAG Rat

More Python MCP servers · Unity API Documentation · Unreal Engine API Documentation · Studiomcphub · Growmos · Omni Nli · see all