@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.

License

MIT

uptrack-mcp