context-doctor MCP server

context-doctor 🩺

Keep every AI session's context lean, automatically, without ever making it more expensive.

Long agent sessions fill up with tool output nobody reads again: file dumps, shell logs, search results, screenshots. You pay for all of it on every request, the model gets slower, and it drifts as the window fills. context-doctor measures that, and with autopilot it removes it from every Claude Code (and GPT API) request on your machine, only at moments when doing so costs nothing extra.

• 9.8% less input cost, no session worse. Replaying 130 days of the author's real Claude Code use (43 sessions) through the shipped code: 3.8 billion input tokens not sent, $4,694 saved at API list price, about $1,080 a month, and not one session more expensive. Up to 37.7% on a long session. What it saves →
• Counts Claude correctly. Current Claude models pack 2.75 characters per token, not the 4 most tools assume; estimates built on 4 undercount Claude by about 40%. The ratios here were measured from the API's own counts, and context-doctor accuracy re-checks them on yours. How →
• Works where you work: Claude Code, Cursor, Codex, Claude Desktop, any Anthropic or OpenAI API app, VS Code, CI. macOS, Linux and Windows, Node 20+.
• Local and keyless. No account, no telemetry, no API key. Your own login passes through untouched. MIT.

Built and maintained by gAI Ventures.

Quick start

See what it would save you first (no install, reads your local Claude Code history):

npx context-doctor savings

What autopilot would have saved you (last 30 days, 53 Claude Code sessions)
────────────────────────────────────────────────────────
Input you were billed for           $11,205   (from the usage your transcripts record)
Autopilot would have cut             $1,396   12.5%, 1.2B tokens not sent
Sessions made more expensive              0
Biggest win                            $503   tech-Whatsit (31% of that session)

That is the author's machine. Yours is computed the same way: every recent session replayed request by request through the shipped autopilot code, against what your transcripts show you were actually billed.

Then install it, whichever way suits you:

# Everything, every app it finds (Claude Code, Cursor, Codex, Claude Desktop)
npm install -g context-doctor
context-doctor install
context-doctor autopilot on     # every new Claude Code session keeps its context lean

# Or as a Claude Code plugin, from inside Claude Code
/plugin marketplace add KushalP1/context-doctor
/plugin install context-doctor@context-doctor

The plugin brings the every-prompt check, the MCP tools, and /context-doctor:savings, /context-doctor:checkup and /context-doctor:autopilot. It needs no npm step: the MCP server ships as one self-contained file, so it also works on Claude Code versions that do not install plugin dependencies.

context-doctor autopilot status shows what autopilot did; context-doctor doctor checks the whole setup. Everything is reversible: context-doctor autopilot off, context-doctor uninstall, or /plugin uninstall.

Shortened. The full README is on GitHub.