Skip to content
Kitbay
MCP server

Headroom

Runs locallyApache-2.0Updated on Nov 17, 202679,934GitHub starsNo API key needed

Headroom is a context-compression layer from Headroom Labs that shrinks tool outputs, logs, files, retrieved chunks and chat history before they reach a language model, running locally, and is offered as a Python library, a proxy and an MCP server.

What it does

Headroom is a context-compression layer from Headroom Labs that shrinks tool outputs, logs, files, retrieved chunks and chat history before they reach a language model, running locally, and is offered as a Python library, a proxy and an MCP server. The MCP server exposes three tools to compress content, retrieve the original when needed and report savings, and is set up with headroom mcp install or started with headroom mcp serve. The npm package headroom-ai that this listing is named after is the TypeScript SDK, which needs the Python proxy running. The project is free under Apache 2.0, with a paid enterprise offer, and anonymous telemetry is on by default.

Capabilities

  • Compress tool outputs and logs before they reach the model
  • Retrieve the original content behind a compressed result
  • Report compression statistics