English Français العربية

io.github.drumbeats-io/mcp

Official registry Productivity

Manage Drumbeats cron, heartbeat and uptime monitors, report job runs and handle incidents.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http io-github-drumbeats-io-mcp 'https://api.drumbeats.io/mcp'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "io-github-drumbeats-io-mcp": {
            "type": "http",
            "url": "https://api.drumbeats.io/mcp"
        }
    }
}
NPM package @drumbeats/mcp
Claude Code 
claude mcp add io-github-drumbeats-io-mcp -e 'DRUMBEATS_API_KEY=<your drumbeats_api_key>' -- npx -y @drumbeats/mcp@0.5.2
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "io-github-drumbeats-io-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@drumbeats/mcp@0.5.2"
            ],
            "env": {
                "DRUMBEATS_API_KEY": "<your drumbeats_api_key>"
            }
        }
    }
}

Environment variables

  • DRUMBEATS_API_KEY secret Drumbeats API key (dk_...). Optional: the HTTP, SSL and DNS checks work without one.

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Drumbeats MCP
  2. What is Drumbeats?
  3. Install
  4. Tools
  5. Example prompts
  6. Try it with zero setup
  7. Configuration
  8. Development
  9. Links
  10. License

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

Nineteen 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

ToolWhat it does
list_projectsList the projects your key can access (with notification channels and groups).
create_projectCreate a new project (account-scoped key with manage_projects).
update_projectUpdate a project's name or description (partial patch).
create_monitorCreate a monitor — cron, heartbeat, or HTTP uptime.
list_monitorsList a project's monitors with type, status, and schedule.
get_monitorFetch one monitor by id, with its full configuration.
update_monitorUpdate an existing monitor (partial patch).
pause_monitorPause a monitor (stops checks and alerts).
resume_monitorResume a paused monitor.

Heartbeat pings

ToolWhat it does
ping_startReport that a job started; returns a run_id to pair with its finish.
ping_successReport that a job succeeded (the heartbeat that keeps a monitor up).
ping_failureReport that a job failed (can open an incident and alert).

The ping tools replace a curl to the monitor's ping URL, which helps where outbound HTTP needs an allowlist (for example Claude Code cloud scheduled tasks). Each takes monitor_id (the monitor UUID) plus optional run_id, message, and payload. On the hosted server they need a token with the manage_monitors scope.

Observe & triage

ToolWhat it does
get_monitor_historyRecent pings, checks, and response times for a monitor.
get_uptime_summaryProject-wide uptime / SLA rollup across monitors.
list_incidentsList incidents (downtime and missed runs), filterable by status or monitor.
manage_incidentGet, acknowledge, or resolve an incident.

Diagnostics — no account required

ToolWhat it does
check_httpCheck a URL's reachability, status code, and response time.
check_sslInspect a TLS certificate — validity, expiry, and issuer.
check_dnsResolve 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

VariableRequiredDefaultDescription
DRUMBEATS_API_KEYFor the monitoring tools—Account-scoped key (dk_…). Not needed for the diagnostics tools.
DRUMBEATS_API_BASE_URLNohttps://api.drumbeats.ioThe 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_URLNo${apex}/idSelf-host override: full base URL for the id service.
DRUMBEATS_BEATS_BASE_URLNo${apex}/beatsSelf-host override: full base URL for the beats service.
DRUMBEATS_ALERTS_BASE_URLNo${apex}/alertsSelf-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.

License

Apache-2.0 © Lucky S Software. See NOTICE.

A product by Lucky S Software.

Frequently asked questions

What is io.github.drumbeats-io/mcp?

Manage Drumbeats cron, heartbeat and uptime monitors, report job runs and handle incidents.

How do I install io.github.drumbeats-io/mcp?

It runs as a remote server. In Claude Code: claude mcp add --transport http io-github-drumbeats-io-mcp 'https://api.drumbeats.io/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.drumbeats-io/mcp need an API key?

Yes. It expects DRUMBEATS_API_KEY, which you set in its configuration.

Is io.github.drumbeats-io/mcp open source?

Yes. Its code is on GitHub under the Apache-2.0 license.

Who maintains io.github.drumbeats-io/mcp?

It is published by drumbeats-io. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.