PingBase MCP Server
Control PingBase from Claude, Cursor, and other AI tools
What is an MCP server?
The Model Context Protocol (MCP) lets AI assistants like Claude call external tools. The PingBase MCP server exposes your monitoring data and controls as AI-callable tools — so you can ask Claude to check your monitors, create new ones, or acknowledge incidents in plain English.
"Which of my monitors are currently down?"
"Create a monitor for https://api.myapp.com that checks every minute and alerts on Slack."
"What was the uptime for my production API last week?"
Installation
The PingBase MCP server runs as a local Node.js process. Install it globally:
npm install -g @pingbase/mcp-serverConnect to Claude Desktop
Edit your Claude Desktop config file to add the PingBase server. The config file is at:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
Add this to the mcpServers section:
{
"mcpServers": {
"pingbase": {
"command": "pingbase-mcp",
"env": {
"PINGBASE_API_KEY": "your_api_key_here"
}
}
}
}Restart Claude Desktop. The PingBase tools will appear in the tools list.
Connect to Cursor
In Cursor, open Settings → MCP and add a new server:
{
"name": "pingbase",
"command": "pingbase-mcp",
"env": {
"PINGBASE_API_KEY": "your_api_key_here"
}
}Available tools
| Tool | What it does |
|---|---|
| list_monitors | Returns all monitors with current status, uptime %, and last check time |
| get_monitor | Gets details for a specific monitor including response time history |
| create_monitor | Creates a new HTTP, keyword, or heartbeat monitor |
| pause_monitor | Pauses a monitor (useful during deployments) |
| resume_monitor | Resumes a paused monitor |
| delete_monitor | Deletes a monitor permanently |
| list_incidents | Lists recent downtime incidents for all or a specific monitor |
| list_alert_channels | Returns configured Slack, Discord, Telegram, and webhook channels |
| get_status_page | Gets status page details and the public URL |
Example prompts
Check current status
"Are any of my monitors currently down? Show me which ones and how long they've been down."
Create a monitor during setup
"I just deployed a new API at https://api.myapp.com/health. Create a monitor that checks it every minute and alerts in my #ops Slack channel."
Deploy workflow
"I'm about to deploy. Pause all my production monitors, then remind me to resume them after."
Incident review
"Show me all incidents from the past 7 days. Which monitor had the most downtime?"
Ready to try it?
The MCP server works on all PingBase plans including the free tier. Get your API key in Settings → API Keys.