Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.devhelm.io/llms.txt

Use this file to discover all available pages before exploring further.

The DevHelm MCP server gives AI coding assistants like Cursor, Claude Desktop, and Windsurf direct access to your monitoring stack. Create monitors, investigate incidents, manage alert channels, and configure status pages — all through natural language in your editor. DevHelm hosts the server at mcp.devhelm.io so there’s nothing to install. Add the URL to your MCP client config and you’re connected.

​
Connect in 30 seconds

All you need is your API token and one config entry. Grab a token from Settings → API Keys in the Dashboard.
Add to .cursor/mcp.json in your project root (or ~/.cursor/mcp.json for global access):
{
  "mcpServers": {
    "devhelm": {
      "url": "https://mcp.devhelm.io/mcp",
      "headers": {
        "Authorization": "Bearer dh_live_xxxxxxxx"
      }
    }
  }
}
That’s it. Restart your MCP client and the DevHelm tools will appear.

​
What you can do

Once connected, talk to your assistant like you would to a teammate:
  • “List all my monitors and their current status” — get a quick overview without leaving your editor
  • “Create an HTTP monitor for api.example.com/health checking every 60 seconds from us-east” — spin up monitoring in seconds
  • “Show me active incidents and the recent check results for the failing one” — investigate without context-switching to the dashboard
  • “Set up a Slack alert channel with this webhook URL” — wire up notifications conversationally
  • “Add api.example.com as a component on the public status page” — manage your status page from chat
  • “What’s the uptime for the payments service over the last 30 days?” — pull reporting data inline
The MCP server covers the entire DevHelm product surface — anything you can do in the dashboard or CLI, your AI assistant can do too.

​
Available tools

The server exposes over 100 tools across 15 categories:
CategoryTools
Monitorslist, get, create, update, delete, pause, resume, test, results, versions
Incidentslist, get, create, resolve
Alert channelslist, get, create, update, delete, test
Notification policieslist, get, create, update, delete, test
Resource groupslist, get, create, update, delete, add/remove members
Tagslist, get, create, update, delete
Environmentslist, get, create, update, delete
Secretslist, get, create, update, delete
API keyslist, get, create, revoke
Webhookslist, get, create, update, delete, test
Status pageslist, get, create, update, delete, components, groups, incidents, subscribers, domains
Forensicsincident timeline, check trace, policy snapshot, rule evaluations, transitions
Dependencieslist, get, track, delete
Deploy lockacquire, current, release, force-release
Status / healthoverview
See the Tools reference for the full per-tool catalog with parameters.

​
Alternative: run locally

If you prefer to run the server on your own machine (offline use, air-gapped environments, or development), the same code is published to PyPI as devhelm-mcp-server. It speaks MCP over stdio. 
uvx devhelm-mcp-server
See Configuration → Run locally for full local setup instructions and per-client config snippets.

​
Next steps

Configuration

Authentication modes, environment variables, local setup, and troubleshooting.

Tools reference

Full per-tool catalog with parameters and return shapes.