Token Optimizer MCP

Tools Token Optimizer MCP exposes (19)

Listed by the server itself during our scan of commit 31ee445.

• token_audit

  The one thing to run. A single ranked queue of what is costing the most in this project -- waste detectors, prompt-cache invalidation attributed to a file and line, and model routing -- each priced per session and per month, each naming how to act on it. Reports what already-applied fixes actually s

• install_doctor

  Check that this installation actually works. Runs the real hook binaries with synthetic payloads and asserts a large read is refused and a small one is not, that session-start emits the policy, and that the graph directory is writable and private -- rather than checking that config files exist, whic

• fleet_audit

  Look across every project on this machine at once: which projects hold the cost (ranked with dollar figures), which fixes proven in one project apply to others containing the SAME FILE CONTENTS, and how enforcing clients compare with directive ones as a natural experiment (reported with its confound

• wiki_write

  Record a durable finding in this project's knowledge graph so a later session retrieves it instead of re-deriving it. Use it the moment you conclude something that cost real work and is not obvious from the code: a dead end and why, a decision and its rejected alternatives, a command that finally wo

• wiki_read

  Retrieve what this project's knowledge graph already records about the files you are about to work on, so you do not re-derive it. Call it BEFORE reading a file you have not seen: it returns prior conclusions anchored to that file — dead ends and why, decisions and what was rejected, commands that w

• wiki_query

  Read the project's knowledge graph: fetch a finding by key, search findings by terms, inspect a node and its neighbours, or get the graph's audit, token balance and overall shape. Use it when the session index mentions a finding you want in full, or to find out what the graph holds at all. NOT for a

• expand

  Retrieve the full output behind a preview reference, served from the local store rather than by re-running anything. Pass `section` to say which named part of the preview you needed -- that is what teaches the next preview to keep it. Pass `claim` and `anchor` to record what you learned, so the same

• waste_audit

  Report behavioural token waste in this project, ranked by cost per session and compared against the previous week. Detectors are a shipped floor plus patterns derived from this project's own history, each carrying what it has actually saved. Use action="apply" to put the fixes we own into force (rev

• cache_audit

  Report Anthropic prompt-cache economics for this project: measured cache-read input, cache-write input, hit rate, and warm prefix size read from a Claude Code transcript, plus likely invalidation sources. Cost equivalents are labeled Anthropic-specific, excluded from universal savings, and are not i

• model_routing

  Which model tier this project's work actually goes better on, measured from episode outcomes in the client transcript rather than guessed from task size. Reports expected cost per tier including retries, and prices BOTH mistakes: what an overpowered model wastes and what an underpowered one costs in

• optimize_text

  Compress and cache text to reduce token usage. Returns compressed version and saves to cache for future use.

• get_cached

  Retrieve previously cached and optimized text. Returns the original text if found in cache.

• optimize_session

  Analyzes operations in the current session from the session JSONL log, identifies large text blocks from file-based tools (Read, Write, Edit), compresses them, and stores them in the cache to reduce future token usage. Returns a summary of the optimization.

• smart_read

  Read files with intelligent caching, diff-based updates, and syntax-aware optimization. Measured token reduction vs reading the file: -2% to 0% first read, 99-99.9% repeated on an unchanged file (bench/tools, 3 fixtures) -- a first read returns the file plus a one-field header, so it still costs a l

• smart_write

  Write files with an unmeasured design target of 85% token reduction through verification, atomic operations, and change tracking

• smart_edit

  Edit files with an unmeasured design target of 90% token reduction through line-based operations and diff-only output

• smart_glob

  Search files with glob patterns and an unmeasured design target of 75% token reduction through path-only results and smart filtering

• smart_grep

  Search file contents with an unmeasured design target of 80% token reduction through match-only output and smart filtering

• get_optimization_report

  Get a provenance-gated token report. Verified savings require a materialized MCP payload before and after optimization; historical and tool-reported estimates are excluded. Direct API-price equivalents use each exact captured model and route; ambiguous operations remain unpriced.

At a glance

Stars

564

Forks

73

Language

JavaScript

License

MIT

Created

Oct 2025

Last update

Nov 1, 2026

Type

MCP Server

Price

Free

Topics

Questions about Token Optimizer MCP

Guides

• How to Install an MCP Server in Claude, Cursor and VS Code
• MCP Server Security: How to Vet a Server Before You Use It
• MCP Tool Poisoning: Malicious Descriptions and Rug Pulls
• Glossary of MCP, skills and agent security terms
• More Coding Agents agents, MCP servers & skills