Token Savior
by Mibayycommunityv0.9.1
250
17
An MCP server that indexes a codebase structurally and exposes tools for finding symbols, source, dependencies, dependents, change impact, and related project metadata. It supports many programming and config file types and is designed to return small, targeted context instead of whole files.
From the registry: Structural codebase MCP server — navigate and edit code by symbol name, not raw text.
Install & configure
Prerequisites
- requiredPythonPython 3.11+
$ python3 --version
Install in your client
Paste into the AI you're chatting with — it will figure out the rest
Please install the `token-savior` MCP server into my current AI client (that's you).
Required prerequisites (do these first if not already done):
- **Python** — Python 3.11+ Run: `python3 --version`
Canonical MCP server config (stdio transport):
- command: `uvx`
- args: ["token-savior"]
- optional environment variables:
- `WORKSPACE_ROOTS`: Comma-separated list of project root paths to index (example: `/path/to/project1,/path/to/project2`)
- `TOKEN_SAVIOR_CLIENT`: Client name for live dashboard attribution (example: `claude-code`)
- `TOKEN_SAVIOR_MAX_FILES`: Max files per project (default 10000) (example: `10000`)
- `TOKEN_SAVIOR_MAX_FILE_SIZE_MB`: Max file size in MB (default 1) (example: `1`)
Note: 53 tools for structural codebase indexing. Supports Python, TS/JS, Go, Rust, C#, C/GLSL. 97% token reduction measured in real sessions.
Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.Note: 53 tools for structural codebase indexing. Supports Python, TS/JS, Go, Rust, C#, C/GLSL. 97% token reduction measured in real sessions.
Tools (27)
find_symbol
Where a symbol is defined — file, line, type, 20-line preview
get_function_source
Full source of a function or method
get_class_source
Full source of a class
get_functions
All functions in a file or project
get_classes
All classes with methods and bases
get_imports
All imports with module, names, line
get_structure_summary
File or project structure at a glance
list_files
Indexed files with optional glob filter
get_project_summary
File count, packages, top classes/functions
search_codebase
Regex search across all indexed files
reindex
Force full re-index
get_edit_context
All-in-one: symbol source + dependencies + callers in one call
get_feature_files
Find files related to a feature keyword and trace imports transitively
get_routes
Detect API routes and pages
Prerequisites
- • Python 3.11+
- • python3
Packages
token-savior
pypiv0.9.1transport: stdio
Details
- Language
- Python
- License
- MIT
- Released
- Apr 6, 2026
- Last commit
- Apr 11, 2026
- Registry name
- io.github.Mibayy/token-savior