@uptrack-app/mcp

MCP server for Uptrack uptime monitoring. Use with Claude.ai, ChatGPT, Cursor, VS Code, Windsurf, or any MCP-compatible AI assistant.

Two transports supported:

• Remote MCP (recommended) — https://api.uptrack.app/mcp with OAuth 2.0 + PKCE. No API key paste, no npm install. Works in Claude.ai, ChatGPT, VS Code (1.100+), Cursor, and Windsurf.
• Stdio (this package) — for offline agents, CI runners, Claude Desktop, and any client that can't reach a remote MCP endpoint.

Remote MCP (OAuth)

The fastest path. Use this if your client supports remote MCP + OAuth.

Client	Install
Cursor	One-click deeplink
VS Code 1.100+	One-click deeplink
Windsurf	One-click deeplink
Claude.ai	Settings → Connectors → Add custom connector → paste https://api.uptrack.app/mcp
ChatGPT	Settings → Connectors → Add remote MCP → paste https://api.uptrack.app/mcp

OAuth handles consent in-app. No API key.

See uptrack.app/dashboard/install for the full install flow with one-click buttons.

Stdio (this package)

Use this when remote MCP isn't available — offline, CI, or Claude Desktop.

Claude Code

claude mcp add uptrack -- env UPTRACK_API_KEY=your_key npx -y @uptrack-app/mcp

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "uptrack": {
      "command": "npx",
      "args": ["-y", "@uptrack-app/mcp"],
      "env": {
        "UPTRACK_API_KEY": "uk_live_..."
      }
    }
  }
}

Cursor / Windsurf

Add to the MCP settings with the same stdio config as Claude Desktop.

Available Tools

Tool	Description
list_monitors	List all monitors with status, URL, interval, uptime
get_monitor	Get details for a specific monitor
create_monitor	Create a new monitor (HTTP, TCP, DNS, SSL, heartbeat)
update_monitor	Update monitor config
pause_monitor	Pause an active monitor
resume_monitor	Resume a paused monitor
delete_monitor	Delete a monitor
list_incidents	List recent incidents
get_incident	Fetch one incident
acknowledge_incident	Acknowledge an open incident

Example Usage

Once connected, ask your AI assistant:

• "List my monitors"
• "Create a monitor for https://example.com that checks every 30 seconds"
• "Are any of my services down right now?"
• "Show me recent incidents"
• "Acknowledge the incident on the API monitor"

Authentication

• Remote MCP: OAuth 2.0 — no API key needed, consent handled in-app.
• Stdio: Generate an API key at uptrack.app/dashboard/api-keys. Free plan includes API access.

Links

• Uptrack — uptime monitoring at 30-second checks, free
• Install guide — step-by-step per client
• OpenAPI spec
• MCP Protocol

License

MIT