# token-savior

> MCP server that saves 97% of AI coding tokens — your AI reads code structurally, not file-by-file. Faster, cheaper, smarter.

- **URL**: https://www.freshcrate.ai/projects/token-savior
- **Author**: Mibayy
- **Category**: MCP Servers
- **Latest version**: `v4.0.0` (2026-05-18)
- **License**: MIT
- **Source**: https://github.com/Mibayy/token-savior
- **Language**: Python
- **GitHub**: 586 stars, 44 forks
- **Registry**: github
- **Tags**: `python`

## Description

MCP server that saves 97% of AI coding tokens — your AI reads code structurally, not file-by-file. Faster, cheaper, smarter.

## Recent releases

| Version | Date | Urgency | Changes |
| --- | --- | --- | --- |
| `v4.0.0` | 2026-05-18 | High | ## What's new  v4.0 simplifies Token Savior to **a single recommended profile** that just works.  ```bash pip install "token-savior-recall[mcp]" ```  ```json {   "mcpServers": {     "token-savior-recall": {       "command": "/path/to/venv/bin/token-savior",       "env": {         "TOKEN_SAVIOR_PROFILE": "optimized",         "WORKSPACE_ROOTS": "/path/to/project"       }     }   } } ```  That's it. `optimized` bundles tiny_plus + thin schemas + capture-disabled.  ## Bench results  \| \| Plain Opus 4 |
| `v3.4.0` | 2026-05-16 | High | ## One profile to rule them all  The new `auto` profile sizes its manifest from your actual telemetry instead of asking you to pick a hand-tuned static subset.  ### How it works - **Essentials** (always exposed): `switch_project`, `list_projects`, `get_git_status`, `ts_search`, `ts_execute`. ~1 KT. - **Hot core**: top-K tools (default K=10) ranked by your persisted `tool_call_counts`. Tune K with `TS_AUTO_HOT_K`. - **Cold start**: falls back to the `tiny_plus` baseline so the first session is st |
| `v2.6.0` | 2026-04-20 | High | ## tsbench (90 paired tasks · Opus 4.7)  \| \| Plain Claude \| Token Savior \| Δ \| \|---\|---:\|---:\|---:\| \| Score \| 120/180 (66.7%) \| **176/180 (97.8%)** \| **+31.1pp** \| \| Active tokens \| 1.55M \| **821k** \| **−47%** \| \| Wall time \| 166min \| **36min** \| **−78%** \| \| W/T/L \| — \| **40 / 48 / 2** \| \|  8 of 11 categories at 100% (audit, bug_fixing, code_generation, code_review, config_infra, documentation, git, refactoring, writing_tests).  ## Bench-driven fixes  - `CLAUDE_PROJECT_ROOT` env auto-promotes a |
| `v2.1.1` | 2026-04-13 | High | ## Highlights  **75 MCP tools** · **891/891 tests** · **97% token reduction** · **Persistent memory across sessions**  This is the recommended release of the v2.1.x line. v2.1.0 was tagged but never published as a Release — use **v2.1.1** instead (CI fixes + private assets removed, no functional change).  ---  ## Phase 2 — Advanced Context Engine  - **Program slicing** via backward Data Dependency Graph (Python AST)   → `get_backward_slice(name, variable, line)` returns the minimal instructions |
| `v1.0.0` | 2026-04-11 | High | # Token Savior v1.0.0 -- Release Notes  **25 files changed, 217 symbols affected. 865 tests passing.**  ## Architecture overhaul  The server has been restructured from a monolithic 2,400-line `server.py` into focused modules:  - **`tool_schemas.py`** -- all 53 MCP tool schemas extracted (server.py reduced to 1,002 lines) - **`cache_ops.py`** -- `CacheManager` class for persistent JSON cache (save, load, legacy migration) - **`slot_manager.py`** -- `SlotManager` + `_ProjectSlot` for multi-project |
| `v0.9.0` | 2026-04-05 | Medium | First public release of Token Savior — structural code intelligence MCP server.  ## What's included - Symbol-level code navigation (get_function_source, get_class_source, find_symbol) - Dependency graphs (get_dependencies, get_dependents, get_change_impact) - Git-aware structural diff (get_changed_symbols, build_commit_summary) - Dead code detection and hotspot analysis - Multi-project support with sub-millisecond queries - 87% token reduction on large codebases |

## Citation

- HTML: https://www.freshcrate.ai/projects/token-savior
- Markdown: https://www.freshcrate.ai/projects/token-savior.md
- Dependencies JSON: https://www.freshcrate.ai/api/projects/token-savior/deps

_Generated by freshcrate.ai. Indexes github releases for AI-agent ecosystem packages._