API & MCP

Agents use MCP with a dic_… API key. The dashboard HTTP API is session-only while you are signed in.

MCP for Cursor and Claude

Sign in at /app
Open MCP / API keys and create a key (shown once)
Point your client at https://diditcron.com/api/mcp with Authorization: Bearer dic_…

Creating a key in the dashboard also shows paste-ready JSON with your real token. Treat keys like passwords; revoke anytime from the same panel.

Cursor

Add to Cursor MCP settings or .cursor/mcp.json:

{
  "mcpServers": {
    "diditcron": {
      "url": "https://diditcron.com/api/mcp",
      "headers": {
        "Authorization": "Bearer dic_YOUR_KEY"
      }
    }
  }
}

If your Cursor build does not support URL + headers yet, use mcp-remote:

{
  "mcpServers": {
    "diditcron": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://diditcron.com/api/mcp",
        "--header",
        "Authorization: Bearer dic_YOUR_KEY"
      ]
    }
  }
}

Claude Desktop

Claude Desktop is stdio-oriented; use mcp-remote as a bridge:

{
  "mcpServers": {
    "diditcron": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://diditcron.com/api/mcp",
        "--header",
        "Authorization: Bearer dic_YOUR_KEY"
      ]
    }
  }
}

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Restart Claude Desktop after editing.

Tools

Tool	Purpose
list_monitors	List monitors
get_monitor	Monitor detail + ping URL
create_monitor	Create one monitor
update_monitor	Edit fields or pause / resume
delete_monitor	Delete a monitor
import_crontab	Import crontab lines; returns suggestedLine curl rewrites
rotate_ping_token	Rotate ping URL
list_recent_alerts	Recent alerts
get_account	Plan, usage, verification

Write tools respect email verification and plan limits. Alert channel setup stays in the dashboard.

Dashboard HTTP API

Browser session routes under /api/monitors. Create, list, update, delete, and import crontab lines while signed in. These routes do not accept API keys. Email must be verified. Monitor count follows your plan.

GET  /api/monitors
POST /api/monitors
POST /api/monitors/import
GET|PATCH|DELETE /api/monitors/:id

Ping URLs themselves stay unauthenticated by design. See Pinging.