Headroom
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
About
- Publisher
- Headroom Labs
Install
- Run this to add it to Any client:
headroom mcp install
MCP servers and skills can run code on your computer and act on your data. Review the source before installing.
Details
| Fact | Value | Source |
|---|---|---|
| Type | MCP server | |
| Tool | Not stated in its documentation | |
| Publisher | Headroom Labs | source |
| Official status | Not stated in its documentation | |
| Connection | Local (runs on your computer) | source |
| Can change data | Not stated in its documentation | |
| Needs an API key or sign-in | No | source |
| Platforms | Not stated in its documentation | |
| AI clients | Not stated in its documentation | |
| Licence | Apache-2.0 | source |
| Pricing | Free | source |
| Activity | Last commit Nov 17, 2026Version 0.44.079,934 GitHub starsDownload data not available (not on npm or PyPI) | source |
| Links | Repository Website npm: headroom-ai |
Sources
- GitHub repositorygithub.com/headroomlabs-ai/headroom · Backs: Needs an API key or sign-in, Pricing, Publisher, Activity, LicenceNov 18, 2026
- npm package recordnpmjs.com/package/headroom-ai/latest · Backs: LicenceNov 15, 2026
- npm package recordnpmjs.com/package/headroom-aiNov 18, 2026