HostTracker MCP server

HostTracker MCP server

Connect an AI assistant to HostTracker over the Model Context Protocol and let it operate your monitoring account in conversation: run a live check from 300+ global locations, see what is down, create or pause a monitor, schedule a maintenance window, review incidents, manage who gets alerted, wire a webhook, publish a status page update.

Endpoint   https://mcp.host-tracker.com/mcp
Transport  streamable HTTP
Auth       OAuth 2.1 (sign in when your client asks) - or Authorization: Bearer <HostTracker API token>

This repository is the public face of that hosted server: the connection metadata (server.json), the per-client setup guide (CLIENT.md), and the security policy (SECURITY.md) - and, since 2.0.0, the server's own source code in src/, so you can read exactly what runs behind the endpoint or run a copy yourself (see "Run it yourself" below).

Connect in two minutes

With OAuth (recommended - Claude.ai, Claude Desktop, Claude Code, ChatGPT and any client with an OAuth-capable connector dialog):

permissions it asks for (by default: run checks + read monitors). Press Approve. No token ever appears.

1. Add the endpoint https://mcp.host-tracker.com/mcp as a connector in your client.
2. Sign in and approve. The client opens HostTracker's sign-in page, then a consent card listing the

checked from Europe and Asia?", "which of my monitors are down?", "pause the staging monitor until tomorrow"*.

1. Ask in plain language: *"is example.com up right now,

Claude Code

With OAuth (no token needed):

claude mcp add --transport http hosttracker https://mcp.host-tracker.com/mcp
# then, inside Claude Code: /mcp -> hosttracker -> Authenticate (opens the sign-in + consent page)

Or with a bearer token in the header:

.mcp.json in your project (or ~/.claude.json for a user-wide connector):

{
  "mcpServers": {
    "hosttracker": {
      "type": "http",
      "url": "https://mcp.host-tracker.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_HOSTTRACKER_API_TOKEN" }
    }
  }
}

Or from the command line:

claude mcp add --transport http hosttracker https://mcp.host-tracker.com/mcp \
  --header "Authorization: Bearer YOUR_HOSTTRACKER_API_TOKEN"

Claude.ai and Claude Desktop

Settings -> Connectors -> Add custom connector -> paste https://mcp.host-tracker.com/mcp -> Connect. The browser opens HostTracker's sign-in + consent page; press Approve and the connector is live. That is the whole setup.

To use a bearer token instead (for example a long-lived token with a hand-picked scope set), Desktop can also connect through the mcp-remote bridge. Edit claudedesktopconfig.json:

{
  "mcpServers": {
    "hosttracker": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote", "https://mcp.host-tracker.com/mcp",
        "--header", "Authorization:${HT_AUTH}"
      ],
      "env": { "HT_AUTH": "Bearer YOUR_HOSTTRACKER_API_TOKEN" }
    }
  }
}

The ${HT_AUTH} indirection is deliberate: some mcp-remote builds split an argument on its first space, which breaks a literal Authorization: Bearer .... Node.js 18 or newer is required.

Cursor

~/.cursor/mcp.json for every project, or .cursor/mcp.json for one:

Shortened. The full README is on GitHub.