Token Savior
Let your coding agent find functions, classes, and modules by symbol and apply structural edits instead of pasting whole files into context.
Overview
Token Savior is an MCP server for the Build phase that lets agents navigate and edit your codebase by symbol name instead of raw full-file text.
What is this MCP server?
- Navigate codebases by symbol name rather than scrolling raw file text
- Structural edits aligned to AST-level targets to cut redundant context
- PyPI package token-savior v0.9.1 with stdio MCP transport
- Requires WORKSPACE_ROOTS with comma-separated absolute project paths to index
- Optional TOKEN_SAVIOR_CLIENT for attribution (claude-code, cursor, hermes)
- PyPI package token-savior version 0.9.1
- Required env WORKSPACE_ROOTS; optional TOKEN_SAVIOR_CLIENT
- Repository: github.com/Mibayy/token-savior
Community signal: 974 GitHub stars.
What problem does it solve?
Agents waste context and make sloppy edits when every turn re-ingests entire files instead of addressing the specific function or type you care about.
Who is it for?
Solo developers on medium or large repos who hit token limits or noisy diffs when agents read whole files repeatedly.
Skip if: Greenfield one-file scripts with no structure, or teams that forbid local indexing of workspace paths for compliance reasons.
What do I get? / Deliverables
After indexing your workspace roots, your agent can resolve symbols and apply structural changes with smaller, more accurate context windows.
- Symbol-level navigation across configured workspace roots
- Structural edits without full-file re-reads in agent context
- Lower token usage on repeated codebase exploration turns
Recommended MCP Servers
Journey fit
Day-to-day implementation is where token-heavy file dumps hurt cost, latency, and accuracy—structural navigation belongs on the build shelf. Agent-tooling is the canonical home for MCP servers that change how Claude Code and Cursor interact with your repo, not one-off launch or SEO tasks.
How it compares
Structural symbol MCP for code navigation, not a generic filesystem read skill or cloud IDE.
Common Questions / FAQ
Who is Token Savior for?
Indie builders using MCP-enabled agents who need cheaper, sharper code navigation and edits across one or more local project roots.
When should I use Token Savior?
Use it during active build and refactor work when file-at-a-time context is slowing the agent or causing wide accidental edits.
How do I add Token Savior to my agent?
pip install token-savior, set WORKSPACE_ROOTS to your absolute project paths, add the stdio MCP server in Claude Code or Cursor, and optionally set TOKEN_SAVIOR_CLIENT.