Skip to main content

Seiri MCP

The official Model Context Protocol server lets AI agents create Seiri monitors and return ready-to-paste heartbeat snippets — so a new client job can be wired without guessing URLs from docs.

Package: @seiri-app/mcp · Support: support@seiri.app · Contact: hello@seiri.app

What it does​

Without MCPWith MCP
Agent reads docs, may invent cloud.seiri.app URLsAgent calls seiri_integrate_job
You copy endpoint IDs from the dashboardTool returns ping.seiri.app URLs + curl/Python/Node/crontab
Manual channel / email setupTools for channels and email heartbeats

Canonical human docs remain at Integrate a job. MCP is the automation layer on top.

Install (Cursor / Claude Desktop)​

{
  "mcpServers": {
    "seiri": {
      "command": "npx",
      "args": ["-y", "@seiri-app/mcp"],
      "env": {
        "SEIRI_API_URL": "https://cloud.seiri.app",
        "SEIRI_INGEST_URL": "https://ping.seiri.app",
        "SEIRI_TOKEN": "<access-token>",
        "SEIRI_ORG_ID": "<numeric-org-id>"
      }
    }
  }
}

Get an access token from a signed-in session (same as CLI). Set SEIRI_ORG_ID from the org switcher / seiri_list_organizations tool. Long-lived org API keys (sk_…) are rolling out and will work as SEIRI_TOKEN / SEIRI_API_KEY when available.

Preferred agent flow​

  1. Prompt: “Create a Seiri Cron monitor for our nightly backup at 0 2 * * * and wire the ping into backup.py.”
  2. Agent calls seiri_integrate_job with webhook_type=cron.
  3. Agent applies returned snippets to the repo.
  4. Agent optionally calls seiri_ping to verify.

Or use the built-in prompt onboard_new_client / integrate_cron_job.

Tools (summary)​

  • seiri_integrate_job — create + snippets (start here)
  • seiri_create_webhook / seiri_list_webhooks / seiri_get_webhook / seiri_find_webhook
  • seiri_delete_webhook (requires confirm=true)
  • seiri_test_webhook / seiri_list_webhook_logs
  • seiri_list_channels / seiri_configure_email_heartbeat
  • seiri_get_ping_urls / seiri_ping
  • seiri_whoami / seiri_list_organizations

Resources: seiri://docs/integrate-jobs, seiri://docs/domains.

Domains​

HostRole
cloud.seiri.appManagement API + dashboard
ping.seiri.appHeartbeats only

Ping URL shape:

https://ping.seiri.app/webhook/<org-slug>:<webhook-ref>/success

Hosted HTTP mode​

SEIRI_MCP_TRANSPORT=http \
SEIRI_MCP_HOST=0.0.0.0 \
SEIRI_MCP_PORT=3100 \
SEIRI_MCP_AUTH_TOKEN=... \
SEIRI_TOKEN=... \
SEIRI_ORG_ID=... \
npx -y @seiri-app/mcp
  • MCP: /mcp
  • Health: /healthz

See the package README on GitHub / npm for Docker.

See also​