# token-pilot

This MCP server lets coding assistants inspect file structure or specific symbols instead of loading large files in full. Useful when code reading fills the conversation context.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 5
- Author: Digital-Threads
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Digital-Threads/token-pilot
- Updated: 2026-10-20
- HTML: https://affpapa.org/en/nevibecode/mcp/token-pilot

## What it does

\`token-pilot` supplies MCP tools for structural code reading: ask for a file outline or retrieve a named symbol. Hooks for Claude Code and Codex can reroute some costly `Read`, `Grep`, and `Bash` calls; Claude Code also gets `tp-*` subagents. Small files are returned whole.

MCP tools are available in Claude Code, Codex, Cursor, GitHub Copilot, and Gemini CLI. Hooks and subagents have narrower client support: Cursor gets the MCP tools, but not the hooks or `tp-*` agents. That distinction matters if you expect automatic interception of native tool calls. To add the server to Claude Code, run `claude mcp add token-pilot -- npx -y token-pilot`, then restart the assistant.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add token-pilot -- npx -y token-pilot
```

### Codex

**Platform CLI**
```bash
codex mcp add token-pilot -- npx -y token-pilot
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "token-pilot": {
            "command": "npx",
            "args": [
                "-y",
                "token-pilot"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "token-pilot": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "token-pilot"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add token-pilot npx -y token-pilot
```

## When to use it
- inspect a large file without loading it all
- locate a named symbol in source code
- review a concise diff after editing
- reduce context spent on code searches

## Example prompts
- Use `smart_read` to outline `src/user-service.ts`.
- Find `UserService.updateUser` with `read_symbol`.
- Show the changes to `src/user-service.ts` using `read_diff`.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 392262
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33989
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81163
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119231
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47577
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43902

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md