token-pilot — Claude Code MCP server: code reading and setup
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.
claude mcp add token-pilot -- npx -y token-pilotWhat token-pilot 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.
What it helps with
- 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 for the agent
- Use
smart_readto outlinesrc/user-service.ts. - Find
UserService.updateUserwithread_symbol. - Show the changes to
src/user-service.tsusingread_diff.
How to install token-pilot
Platform CLI
claude mcp add token-pilot -- npx -y token-pilotPlatform CLI
codex mcp add token-pilot -- npx -y token-pilotConfig file
{
"mcpServers": {
"token-pilot": {
"command": "npx",
"args": [
"-y",
"token-pilot"
]
}
}
}Config file
{
"servers": {
"token-pilot": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"token-pilot"
]
}
}
}Platform CLI
gemini mcp add token-pilot npx -y token-pilotStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about token-pilot
How do I install token-pilot in Claude Code?
Run claude mcp add token-pilot -- npx -y token-pilot, then restart Claude Code.
What does token-pilot do?
It provides MCP tools for structural file reading and symbol lookup. Hooks can reroute some heavy read and search calls.
Does token-pilot support hooks in Cursor?
Cursor can use token-pilot’s MCP tools, but its hooks and tp-* subagents are not supported there.
