Drumbeats

CI npm License: Apache-2.0 drumbeats-io/mcp MCP server smithery badge

The official Model Context Protocol server for Drumbeats — run your monitoring from any AI client. Create monitors, triage incidents, and run HTTP / SSL / DNS checks in plain language from Claude, Cursor, VS Code, or any MCP-capable tool.

What is Drumbeats?

Drumbeats is heartbeat and uptime monitoring for background jobs and services — cron jobs, queues, scheduled tasks, and HTTP endpoints. If a job stops checking in or a site goes down, Drumbeats alerts you. Create a free account at drumbeats.io.

Install

Add the server to your AI client and set one environment variable — your Drumbeats account API key:

{
  "mcpServers": {
    "drumbeats": {
      "command": "npx",
      "args": ["-y", "@drumbeats/mcp"],
      "env": { "DRUMBEATS_API_KEY": "dk_your_key" }
    }
  }
}

1. Get a key — at drumbeats.io → Account → API keys. An account-scoped key (dk_…) works across every project you own or belong to.
2. Add the config — paste the block above into your client's MCP config and restart it.
3. Ask — "List my monitors."

Claude Desktop: prefer a one-click install — download the latest .mcpb bundle from the Releases page, double-click it, and paste your key when prompted.

Requires Node.js 22 when running via npx.

Tools

Sixteen tools over one shared layer. The HTTP / SSL / DNS diagnostics work with no account and no API key — point any client at the server and start checking.

Projects & monitors

Observe & triage

Diagnostics — no account required

Example prompts

List all my monitors and their current status.
Create a cron monitor for my nightly backup that runs every day at 02:00 UTC.
What's my uptime this month?
Show me open incidents and acknowledge the most recent one.
Is https://example.com up right now?            # no account needed
Is the SSL certificate for example.com about to expire?   # no account needed

Try it with zero setup

The check_http, check_ssl, and check_dns tools need no Drumbeats account or API key. Add the server, leave DRUMBEATS_API_KEY unset, and ask "Is my site up?" before you sign up. When you're ready for continuous monitoring and alerts, create a free account.

Configuration

Development

Requires the Node version in .nvmrc.

npm ci          # install dependencies
npm run build   # compile TypeScript to dist/
npm run lint    # Biome lint + format check
npm test        # run the test suite

See CONTRIBUTING.md for the contribution workflow and SECURITY.md for the security policy. This is a security product — please report vulnerabilities privately.

Links

• Product: drumbeats.io · sign up
• Issues: github.com/drumbeats-io/mcp/issues

License

Apache-2.0 © Lucky S Software. See NOTICE.

A product by Lucky S Software.