Headroom runs on your own machine — the client starts it, so there is no endpoint to ping. 1 283 installs a week from npm. Last commit 24 Oct 2026.
Live subscription limits, resets and budget checks for coding agents over MCP.
What the code does
We read the source, 2 d ago · rules 995398eba69f
What this server is able to do. For an MCP server this is often the job itself — a terminal server runs commands because that is what it is for. Listed so you know what you are plugging in, not as an accusation.
const child = spawn(process.execPath, [warningSuppressionFlag(process.versions.node), target, ...process.argv.slice(2)], { stdio: "inherit", env: childEnvironment() });
let process = Process()
export const SOURCE_SERIF_WOFF2_BASE64 = "d09GMgABAAAAACnYABEAAAAAZgAAACl1AAQBBgAAAAAAAAAAAAAAAAAAAAAAAAAAGUYaFhvFKhyBKgZgP1NUQVReAIF+EQgK8TjbNAE2AiQDhBALggoABCAFhWoHIAwHG8JYRQdixjgA8KBvFFHMhuT/SwKVw3ZIh5+okpSIRq1WFESE9mnf2tzE2vK1bbwnJNU/4xQM9MBX3ZtVz++P8vjLMI7jzDlvlWagMQoojtDYJ7…
const TELEGRAM_ORIGIN = "https://api.telegram.org";
Is this your server and something here is wrong? Tell us — corrections are free and do not require a plan.
This code can reach further than it looks
We found places where it runs commands, builds paths or queries from values it is given. None of that is a flaw by itself — it becomes one when the code changes, and code changes quietly between releases. We re-read it on every one.
Connect this server
This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.
claude mcp add headroom -- npx -y headroomd{
"mcpServers": {
"headroom": {
"command": "npx",
"args": [
"-y",
"headroomd"
]
}
}
}[mcp_servers.headroom]
command = "npx"
args = ["-y", "headroomd"]{
"mcpServers": {
"headroom": {
"command": "npx",
"args": [
"-y",
"headroomd"
]
}
}
}{
"servers": {
"headroom": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"headroomd"
]
}
}
}Alternatives to Headroom
same job, measured the same wayThe local security layer for coding agents: secret redaction, injection checks and an MCP proxy.
Read-only MCP server for coding-agent traces, alerts, costs, usage, and budget health.
See each coding-agent subscription's live limits and offload work to one with headroom.
OS keychain secrets for AI coding agents, over MCP.
Search O'Reilly for tech books, courses, events, and more. Requires an O'Reilly subscription.
Recraft AI Image Generation MCP Server for AI coding agents
Code knowledge graph over MCP: token-budgeted context for AI coding agents.
Local-first, persistent memory for AI coding agents — remember, recall, forget, and list, over MCP.
Headroom — questions
Answers built from our own checks of this server.