Drumbeats MCP

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 | Tool | What it does | | --- | --- | | list_projects | List the projects your key can access (with notification channels and groups). | | create_project | Create a new project (account-scoped key with manage_projects). | | update_project | Update a project's name or description (partial patch). | | create_monitor | Create a monitor — cron, heartbeat, or HTTP uptime. | | list_monitors | List a project's monitors with type, status, and schedule. | | get_monitor | Fetch one monitor by id, with its full configuration. | | update_monitor | Update an existing monitor (partial patch). | | pause_monitor | Pause a monitor (stops checks and alerts). | | resume_monitor | Resume a paused monitor. |

Observe & triage | Tool | What it does | | --- | --- | | get_monitor_history | Recent pings, checks, and response times for a monitor. | | get_uptime_summary | Project-wide uptime / SLA rollup across monitors. | | list_incidents | List incidents (downtime and missed runs), filterable by status or monitor. | | manage_incident | Get, acknowledge, or resolve an incident. |

Diagnostics — no account required | Tool | What it does | | --- | --- | | check_http | Check a URL's reachability, status code, and response time. | | check_ssl | Inspect a TLS certificate — validity, expiry, and issuer. | | check_dns | Resolve a hostname and report its DNS records. |

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

| Variable | Required | Default | Description | | --- | --- | --- | --- | | DRUMBEATS_API_KEY | For the monitoring tools | — | Account-scoped key (dk_…). Not needed for the diagnostics tools. | | DRUMBEATS_API_BASE_URL | No | https://api.drumbeats.io | The apex REST URL. The Drumbeats API is split across services by path prefix (/id, /beats, /alerts); the client appends the per-service prefix to this apex per request. | | DRUMBEATS_ID_BASE_URL | No | ${apex}/id | Self-host override: full base URL for the id service. | | DRUMBEATS_BEATS_BASE_URL | No | ${apex}/beats | Self-host override: full base URL for the beats service. | | DRUMBEATS_ALERTS_BASE_URL | No | ${apex}/alerts | Self-host override: full base URL for the alerts service. |

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.