@mnicole-dev/updown-mcp-server

@mnicole-dev/updown-mcp-server

A Model Context Protocol (MCP) server for the Updown.io website monitoring API. Manage checks, view downtimes and metrics, configure alert recipients, and control status pages from any MCP-compatible client.

Features

15 tools covering the full Updown.io API:

Checks (5 tools)

| Tool | Description | |------|-------------| | list-checks | List all monitoring checks with status, uptime, and apdex | | get-check | Get details for a single check, optionally including metrics | | create-check | Create a new URL monitoring check | | update-check | Update check settings (URL, period, threshold, headers, etc.) | | delete-check | Delete a monitoring check |

Downtimes & Metrics (2 tools)

| Tool | Description | |------|-------------| | get-check-downtimes | Get downtime history for a check (paginated) | | get-check-metrics | Get performance metrics (apdex, uptime, timings) for a time range |

Nodes (1 tool)

| Tool | Description | |------|-------------| | list-nodes | List all global probe locations used by Updown.io |

Recipients (3 tools)

| Tool | Description | |------|-------------| | list-recipients | List all alert recipients (email, Slack, webhooks, SMS) | | create-recipient | Create a new alert recipient | | delete-recipient | Delete a recipient |

Status Pages (4 tools)

| Tool | Description | |------|-------------| | list-status-pages | List all status pages | | create-status-page | Create a new public or private status page | | update-status-page | Update a status page | | delete-status-page | Delete a status page |

Requirements

• Node.js 18+
• An Updown.io account with an API key (get it here)

Installation

npm install -g @mnicole-dev/updown-mcp-server

Or run directly with npx:

npx @mnicole-dev/updown-mcp-server

Configuration

Set the following environment variable:

export UPDOWN_API_KEY=your-api-key

Claude Code

Add to your ~/.claude.json:

{
  "mcpServers": {
    "updown": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@mnicole-dev/updown-mcp-server"],
      "env": {
        "UPDOWN_API_KEY": "your-api-key"
      }
    }
  }
}

Claude Desktop

Add to your config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "updown": {
      "command": "npx",
      "args": ["-y", "@mnicole-dev/updown-mcp-server"],
      "env": {
        "UPDOWN_API_KEY": "your-api-key"
      }
    }
  }
}

Examples

Check status of all your monitors

> Show me all my monitoring checks and their current status

Investigate downtime

> Show me the downtime history for check abc123

Get performance metrics

> Get metrics for check abc123 between 2024-01-01 and 2024-01-31, grouped by time

Create a new monitor

> Create a check for https://myapp.com every 30 seconds with alias "My App" and apdex threshold 0.5

Manage recipients

> List all my alert recipients and create a new email recipient for alerts@myteam.com

Create a status page

> Create a public status page with checks abc123 and def456, named "My Services Status"

How it works

1. The MCP client sends a tool call to the server via stdio
2. The server authenticates with Updown.io using the X-API-KEY header
3. Requests are sent to https://api.updown.io
4. Responses are formatted as human-readable markdown text and returned

Development

git clone https://github.com/mnicole-dev/updown-mcp-server.git
cd updown-mcp-server
pnpm install
pnpm dev          # Run with tsx (requires UPDOWN_API_KEY)
pnpm build        # Build to dist/

License

MIT