# Pingdom — how to use (mcp.ai)

Connect your Pingdom account and use 13 tools for server monitoring straight from your AI agent. Connect with your own API key. Pingdom is a web performance monitoring service that allows users to monitor the uptime and performance of websites, servers, and applications.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_pingdom?ms=1787291520000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `pingdom_get_actions_alerts`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/pingdom`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/pingdom/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/pingdom/get/actions/alerts` — Retrieves configured alert actions (notifications) from your Pingdom account. Alert actions define how and where notifications are sent when checks trigger alerts (e.g., email, SMS, webhooks, integrat
  - body: { via?: string[], limit?: integer, start?: integer, endtime?: integer, userids?: integer[], checkids?: integer[], starttime?: integer }
- `POST https://api.mcp.ai/api/pingdom/get/checks/list` — Retrieves a list of all uptime/monitoring checks configured in Pingdom with optional filtering and pagination. Use this to: view all monitoring checks, filter by status/type/tags, search by name, or p
  - body: { name?: string, tags?: string, team?: integer, type?: string, limit?: integer, offset?: integer, status?: string, probeids?: string, transaction?: boolean, include_tags?: boolean, integrationids?: string }
- `POST https://api.mcp.ai/api/pingdom/get/contact/details` — Retrieves comprehensive details of a specific Pingdom alerting contact by ID, including all configured notification methods (email, SMS), team memberships, contact type, and pause status. Use this whe
  - body: { contactid: integer }
- `POST https://api.mcp.ai/api/pingdom/get/contacts` — Tool to retrieve all alerting contacts. Use when you need to list every contact along with their notification targets after establishing a Pingdom session.
- `POST https://api.mcp.ai/api/pingdom/get/credits` — Retrieves comprehensive account information including check limits, SMS credits, and resource usage. Use this to monitor available checks (uptime and transaction), SMS credits, RUM sites, and alerting
- `POST https://api.mcp.ai/api/pingdom/get/list/maintenance/occurrences` — Tool to list maintenance occurrences. Use when you need occurrences filtered by time range or a specific maintenance window ID.
  - body: { limit?: integer, offset?: integer, to_time?: integer, from_time?: integer, maintenancewindowid?: integer }
- `POST https://api.mcp.ai/api/pingdom/get/maintenance/windows` — Tool to retrieve a list of maintenance windows. Use when you need to list user's maintenance windows with optional pagination and time range filters.
  - body: { limit?: integer, offset?: integer, to_time?: integer, from_time?: integer }
- `POST https://api.mcp.ai/api/pingdom/get/probes` — Retrieves the complete list of Pingdom probe servers worldwide. This action returns all available probe servers that can be used for monitoring checks. Probes are distributed globally across regions (
- `POST https://api.mcp.ai/api/pingdom/get/reference/data` — Retrieves Pingdom reference data including regions, timezones, datetime formats, number formats, and countries. This data is used for configuring Pingdom account settings, checks, and understanding av
- `POST https://api.mcp.ai/api/pingdom/get/single/check` — Perform a single on-demand Pingdom check against a target host. This executes an immediate test from a specified probe (or random probe if not specified) and returns the result. Use this when you need
  - body: { url?: string, host: string, port?: integer, type: string, probeid?: integer, expectedip?: string, stringtosend?: string, stringtoexpect?: string }
- `POST https://api.mcp.ai/api/pingdom/get/team/details` — Tool to fetch detailed information for a specific alerting team. Use after listing teams to get full members and integrations details.
  - body: { teamid: integer }
- `POST https://api.mcp.ai/api/pingdom/get/teams` — Tool to retrieve all alerting teams and their members. Use after authenticating to Pingdom to manage team configurations.
- `POST https://api.mcp.ai/api/pingdom/get/tms/transaction/checks/list` — Retrieves a paginated list of all transaction (TMS) checks configured in Pingdom. Transaction checks (also called TMS checks) are synthetic monitoring tests that simulate user interactions with web ap
  - body: { limit?: integer, offset?: integer }

## Example prompts
- "What can I do in Pingdom?"
- "Show me a summary of my Pingdom account"

## More
- Page: https://mcp.ai/pingdom
- Agent spec (llms.txt): https://mcp.ai/pingdom/llms.txt
- Postman collection: https://mcp.ai/pingdom/postman.json