API & MCP

Automate your monitoring with REST or MCP

Integrate monitoring into your workflow with a REST API — or point an agent at the same capabilities over Streamable HTTP MCP.

  • API key scopes
  • MCP tools
  • Cron-job ping endpoint
Deep Dive

Every dashboard action, scripted

A closer look at what you get, from the first check to the alert that reaches you.

Scoped API keys

Issue keys with only the permissions each integration needs, including an mcp scope for agents.

Full resource coverage

Monitors, DNS/TCP monitors, alerts, maintenance windows, status pages, and more — as REST and as MCP tools.

Streamable HTTP MCP

Connect an agent with mcp-bridge from @sdxc/mcp (protocol 2026-07-28) to https://uptime.sergiodxa.com/mcp.

Cron-job ping endpoint

A dedicated public endpoint your scheduled jobs call to report a heartbeat.
Get started

From a scoped key to automation

Three steps from an empty dashboard to checks that run on their own.

  1. Create an API key

    Generate a key with mcp plus the resource scopes your tools need.
  2. Call the API or MCP

    Use REST from scripts, or MCP tools from an agent — same scopes either way.
  3. Automate your workflow

    Wire monitoring into deploy scripts, infrastructure tooling, or agents.
curl https://uptime.sergiodxa.com/api/v1/monitors \
  -H "Authorization: Bearer uptime_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Production API",
    "url": "https://api.example.com/health",
    "method": "GET",
    "expectedStatus": 200,
    "intervalSeconds": 60
  }'
{
  "command": "npx",
  "args": [
    "-y",
    "@sdxc/mcp@latest",
    "https://uptime.sergiodxa.com/mcp",
    "--header",
    "Authorization:Bearer ${UPTIME_MCP_TOKEN}"
  ]
}
FAQ

Frequently asked questions

The questions people ask most before they start monitoring.

Is there a public API?

Yes — a full REST API with scoped API keys covers monitors, alerts, and more.

Can agents use Uptime?

Yes — POST /mcp is Streamable HTTP MCP. Keys need the mcp scope plus the same resource scopes as REST.

How do scheduled jobs report in?

Each cron-job monitor gets a dedicated public ping URL your job calls on completion.

Start monitoring your services

Create your first monitor in under 2 minutes. No credit card required to start.