UptyBots MCP Server

Connect AI assistants like Claude, Cursor, and other MCP-compatible tools to your UptyBots uptime monitors.

What is this?

An MCP (Model Context Protocol) server that gives AI assistants access to your UptyBots monitoring data. Ask your AI to check monitor status, review incidents, create new monitors, and more — through natural conversation.

You probably want the hosted server instead

There is now a remote server that needs no install and no API key:

https://mcp.uptybots.com/mcp

Add that URL to your client and it opens a browser for you to sign in and approve access. If you do not have an UptyBots account yet, you can create one at that step.

With Claude Code:

claude mcp add --transport http uptybots https://mcp.uptybots.com/mcp

then run /mcp, pick uptybots and authenticate.

This package is the local alternative. It runs on your own machine and authenticates with an API key instead of a browser sign-in — the right choice for MCP clients that cannot talk to remote servers, and for offline or self-contained setups. It exposes the same 15 tools and is not going away.

Prerequisites

• Node.js 18 or later
• A UptyBots account
• An API key from Account → API Keys

Setup

1. Configure your AI client

No install step needed: npx fetches the published package on first run.

Add to your MCP client configuration:

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "uptybots": {
      "command": "npx",
      "args": ["-y", "uptybots-mcp-server"],
      "env": {
        "UPTYBOTS_API_URL": "https://uptybots.com",
        "UPTYBOTS_API_KEY": "upty_your_api_key_here"
      }
    }
  }
}

Claude Code (~/.claude/settings.json) and Cursor (.cursor/mcp.json) use the same format.

2. Restart your AI client

The MCP tools will be available immediately.

Running from source (optional)

To run a local checkout instead of the npm package:

git clone https://github.com/uptybots/mcp-server.git
cd mcp-server
npm install

Then point the client at the checkout:

{
  "mcpServers": {
    "uptybots": {
      "command": "node",
      "args": ["/path/to/mcp-server/index.js"],
      "env": {
        "UPTYBOTS_API_URL": "https://uptybots.com",
        "UPTYBOTS_API_KEY": "upty_your_api_key_here"
      }
    }
  }
}

Available Tools (15)

Read

Tool	Description
list_monitors	List all monitors with filters (type, status)
get_monitor	Get monitor details by ID
get_incidents	Get downtime incidents for a monitor
get_stats_hourly	Hourly performance stats
get_stats_daily	Daily performance stats
get_notifications	Notification history

Create

Tool	Description
create_http_monitor	Create HTTP/HTTPS monitor
create_api_monitor	Create API endpoint monitor
create_ping_monitor	Create ICMP ping monitor
create_port_monitor	Create TCP port monitor
create_ssl_monitor	Create SSL certificate monitor
create_domain_monitor	Create domain expiration monitor

Manage

Tool	Description
pause_monitor	Pause a monitor
resume_monitor	Resume a paused monitor
delete_monitor	Delete a monitor

Environment Variables

Variable	Required	Description
UPTYBOTS_API_URL	No	API base URL (default: https://uptybots.com)
UPTYBOTS_API_KEY	Yes	Your API key (starts with upty_)

Documentation

• MCP Server Docs — full setup guide and tool reference, covering both the hosted server and this one
• REST API Reference — the API that powers the MCP server
• Account → Connected Applications — review and revoke access granted through the hosted server

License

MIT