Official MCP server for Drumbeats. Create and manage cron, heartbeat and uptime monitors, report job runs and handle incidents from Claude, Cursor or VS Code.
Overview
Drumbeats watches cron jobs, background workers and websites. When a job misses its schedule, reports a failure or a site stops answering, it opens an incident and alerts you. This is the official Model Context Protocol server for Drumbeats. It lets Claude, Cursor, VS Code and other MCP clients work with your account: create monitors, read their history, report job runs and handle incidents. Three of its tools check a website, a certificate or a DNS name and work without an account. There are two ways to run it. Both give you the same 19 tools. Add https://api.drumbeats.io/mcp to your client and sign in with your Drumbeats account when it asks. Nothing to install and no API key to store. In Claude, open , paste the URL above and sign in. Add this to .cursor/mcp.json in your project, or to the global config, and approve the sign-in on first connect: Add this to .vscode/mcp.json in your workspace: Any client that supports Streamable HTTP with OAuth can connect.
README
Drumbeats watches cron jobs, background workers and websites. When a job misses its schedule, reports a failure or a site stops answering, it opens an incident and alerts you.
This is the official Model Context Protocol server for Drumbeats. It lets Claude, Cursor, VS Code and other MCP clients work with your account: create monitors, read their history, report job runs and handle incidents. Three of its tools check a website, a certificate or a DNS name and work without an account.
Connect
There are two ways to run it. Both give you the same 19 tools.
Hosted server
Add https://api.drumbeats.io/mcp to your client and sign in with your Drumbeats
account when it asks. Nothing to install and no API key to store.
On your machine, with an API key
Create a key at drumbeats.io/account/api-keys. An account key covers every project you own or belong to. A project key limits the server to one project.
Running it with npx needs Node.js 22.
Tools
The “Needs” column is the permission the tool requires: the scope of your API key, or what you approve when you sign in to the hosted server.
Things to ask
List my monitors and tell me which ones are down.
Create a cron monitor for my nightly backup, every day at 02:00 UTC.
What was my uptime over the last 30 days?
Show open incidents and acknowledge the newest one.
Is https://example.com up right now?
When does the certificate for example.com expire?
Configuration
These apply when you run the server with npx. The hosted server needs none of them.
| Variable | Default | What it does |
|---|---|---|
DRUMBEATS_API_KEY |
none | Your API key (dk_…). Needed for every tool except the three checks. |
DRUMBEATS_API_TIMEOUT_MS |
15000 |
How long to wait for the Drumbeats API, in milliseconds. |
DRUMBEATS_API_BASE_URL |
https://api.drumbeats.io |
The API the server talks to. |
Development
Use the Node.js version in .nvmrc.
npm ci # install dependencies
npm run build # compile to dist/
npm run lint # Biome lint and format check
npm test # run the tests
CONTRIBUTING.md covers pull requests and RELEASING.md covers releases. Please report security problems privately, as described in SECURITY.md.
License
Apache-2.0. Copyright 2026 Lucky S Software, see NOTICE. Drumbeats is made by Lucky S Software.
Install
npx -y @drumbeats/mcpConfiguration
{
"mcpServers": {
"drumbeats": {
"url": "https://api.drumbeats.io/mcp"
}
}
}