Heads-up runs on your own machine — the client starts it, so there is no endpoint to ping. 670 installs a week from npm. Last commit 2 Nov 2026.
Spoken voice alerts on Mac, Linux and Windows when your coding agent finishes a task or needs you.
What the code does
We read the source, 4 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.
spawn(process.execPath, [join(ROOT, "settings.mjs")], { detached: true, stdio: "ignore", windowsHide: true }).unref();
$("#barsBase").innerHTML = html;
import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from "node:fs";
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 headsup-mcp -- npx -y headsup-mcp{
"mcpServers": {
"headsup-mcp": {
"command": "npx",
"args": [
"-y",
"headsup-mcp"
]
}
}
}[mcp_servers.headsup-mcp]
command = "npx"
args = ["-y", "headsup-mcp"]{
"mcpServers": {
"headsup-mcp": {
"command": "npx",
"args": [
"-y",
"headsup-mcp"
]
}
}
}{
"servers": {
"headsup-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"headsup-mcp"
]
}
}
}Alternatives to Heads-up
same job, measured the same wayAI agent monitoring: alerts when your agents fail, stall or need you
Read-only MCP server for coding-agent traces, alerts, costs, usage, and budget health.
Homing Pigeon (homingpigeon.dev) sends text alerts from your code or agent to one phone: yours.
AAD from your coding agent: exact Greeks with MatLogica AADC, and a price traced to its source line
Your coding agent adds Probecast uptime monitors and reads incidents for projects you ship.
Uptime checks, cron heartbeats, status pages and alerts, set up by your agent.
Coordination rooms for AI coding agents: path locks, tasks, and conflict alerts. Metadata only.
Free hosted MCP server: new Upwork jobs for your agent and Telegram alerts within a minute.
Heads-up — questions
Answers built from our own checks of this server.