Drumbeats MCP

The official Model Context Protocol server for Drumbeats — operate your monitoring from any AI client. Create monitors, triage incidents, and run HTTP / SSL / DNS checks in natural language.

Status: pre-release scaffold. This repository currently contains the project skeleton — build tooling, the shared tool-layer plumbing, both transports, and OSS standards. The 13 v1 tools and the full onboarding funnel land in upcoming milestones. Interfaces may change before the first tagged release.

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. Learn more and sign up at drumbeats.io.

Related MCP server: uptrack-mcp

Three ways to connect

This server is designed around one shared tool layer exposed over two transports, so the same tools work everywhere. At launch you will be able to connect in three ways, in order of recommendation:

1. Hosted (recommended, zero setup). Add the hosted server as a remote connector in your AI client and authorize in the browser via OAuth — no API keys to manage. Coming at launch.

2. Self-host. Run the exact same server yourself with Docker (see Dockerfile) and point your client at your own instance. Setup guide coming at launch.

3. Local (stdio). Run the published npm package locally with a Drumbeats account API key, for IDE and offline use:

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

   Published to npm at launch.

Tools

The v1 tool set (13 tools — the natural-language monitoring loop plus the HTTP/SSL/DNS diagnostics) is documented here once implemented. Not yet available in this scaffold.

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.