Skip to main content
Glama
uptrack-mcp

uptrack-mcp

Official
by Uptrack-App
README.md
# @uptrack-app/mcp

[MCP](https://modelcontextprotocol.io) server for [Uptrack](https://uptrack.app) 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** | Add a remote MCP server → paste `https://api.uptrack.app/mcp` |
| **VS Code** 1.100+ | Add a remote MCP server → paste `https://api.uptrack.app/mcp` |
| **Windsurf** | Add a remote MCP server → paste `https://api.uptrack.app/mcp` |
| **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. You need an Uptrack account on a paid plan.

See the [Uptrack MCP guide](https://uptrack.app/guides/mcp) for the full install steps.

## Stdio (this package)

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

### Claude Code

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

### Claude Desktop

Add to `claude_desktop_config.json`:

```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**: Create an API key in the dashboard under Settings → API Keys. See [how to use an API key](https://uptrack.app/guides/mcp#api-key). API keys need a paid plan.

## Links

- [Uptrack](https://uptrack.app) — uptime monitoring with 30-second checks and a free plan
- [MCP guide](https://uptrack.app/guides/mcp) — how to connect your client
- [OpenAPI spec](https://api.uptrack.app/openapi.json)
- [MCP Protocol](https://modelcontextprotocol.io)

## License

MIT