
Headroom
If you're burning thousands of tokens on tool outputs, logs, or RAG results before they even reach the LLM, this MCP server gives you compress and retrieve operations that claim 60 to 95 percent savings while preserving answer quality. It routes JSON through SmartCrusher, code through an AST compressor, and prose through a Kompress model, then caches originals locally so the LLM can pull them back with headroom_retrieve if needed. The same library also ships as a proxy and agent wrapper for Claude, Cursor, and Aider. Benchmarks on GSM8K and TruthfulQA show no accuracy drop. You'd reach for this when context windows fill up faster than your budget allows or when you want the same agent behavior at a fraction of the API cost.
- GitHub stars
- 23.9K
- tools
- 3
- transport
- STDIO
Tools
3 toolsPublic tool metadata for what this MCP can expose to an agent.
headroom_compressCompresses context for an MCP client.
Compresses context for an MCP client.
No parameter schema in public metadata yet.
headroom_retrieveRetrieves original content that was compressed.
Retrieves original content that was compressed.
No parameter schema in public metadata yet.
headroom_statsReports compression statistics.
Reports compression statistics.
No parameter schema in public metadata yet.
Sponsors
Readme
Details
- Repository
- github.com/chopratejas/headroom
- Category
- AI & LLM Tools
- Package
headroom- Transport
- STDIO