← Home

MCP server

33 tools · Bearer auth · 60 req/min

Notdown exposes a Model Context Protocol server so your AI editor can manage monitors, channels, and incidents on your behalf. Endpoint: https://notdown.dev/mcp. Auth is a Bearer token — the same Sanctum tokens used for the REST API.

1. Get a token

Once accounts open, generate a token from Settings → API & MCP — it's shown once. Or issue one over HTTP: 

curl -X POST https://notdown.dev/api/v1/auth/token \
  -H 'Content-Type: application/json' \
  -d '{"email":"you@example.com","password":"...","name":"Claude on macbook"}'

2. Configure your editor

Claude Code

claude mcp add notdown --transport http \
  --url https://notdown.dev/mcp \
  --header "Authorization: Bearer <YOUR_TOKEN>"

Cursor

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "notdown": {
      "url": "https://notdown.dev/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

Claude Desktop

Open Settings → Connectors → Add custom connector. URL: https://notdown.dev/mcp. Header Authorization with value Bearer <YOUR_TOKEN>.

3. What it can do

Tools are organised by monitor type. Each type exposes the same verb set (add, list, get, pause/resume, mute/unmute, delete); uptime and cron also expose list_*_incidents.

Uptime monitors

7 tools
  • add_uptime_monitor
  • list_uptime_monitors
  • get_uptime_monitor
  • pause_uptime_monitor
  • resume_uptime_monitor
  • delete_uptime_monitor
  • list_uptime_incidents

Cron monitors

7 tools
  • add_cron_monitor
  • list_cron_monitors
  • get_cron_monitor
  • pause_cron_monitor
  • resume_cron_monitor
  • delete_cron_monitor
  • list_cron_incidents

Domain monitors

6 tools
  • add_domain_monitor
  • list_domain_monitors
  • get_domain_monitor
  • pause_domain_monitor
  • resume_domain_monitor
  • delete_domain_monitor

SSL monitors

6 tools
  • add_ssl_monitor
  • list_ssl_monitors
  • get_ssl_monitor
  • pause_ssl_monitor
  • resume_ssl_monitor
  • delete_ssl_monitor

Channels

2 tools
  • list_channels
  • create_channel

Maintenance

5 tools
  • add_maintenance
  • list_maintenances
  • get_maintenance
  • update_maintenance
  • delete_maintenance

4. Permanence & safety

delete_* tools are annotated destructive — most clients ask for confirmation. pause stops the check from running; mute keeps the check running but suppresses alerts for a number of seconds. Both are reversible.

5. Rate limits

Token-scoped rate limit is 60 requests per minute, shared across both the MCP server and the REST API. Limits reset on a rolling window; the response includes standard X-RateLimit-* headers.