Pingstack

Pingstack MCP server

Pingstack monitors cron jobs and scheduled tasks with heartbeat checks, and checks websites, TCP ports, DNS records, SSL certificates and domain expiry. Its MCP server lets your coding agent set up that monitoring and read the results for you.

Ask your agent to add a heartbeat check for the backup job it just wrote, with the right cron schedule, time zone and grace period. Ask which checks had incidents last week and how long they were down. Ask for your API's p95 latency over the last 30 days.

This repository holds the setup files and directory listings for the hosted server. The server itself runs at Pingstack, so there's nothing to install or run locally.

Connect

You need a Pingstack account. Sign up free, then add the server to your client. Leave out any Authorization header: the client opens your browser, an Owner or Admin picks the Pingstack account, and you approve the connection. Clients register themselves, so there's no client ID or secret to copy.

Claude Code

claude mcp add --transport http pingstack https://app.pingstack.io/mcp

Then run /mcp, choose pingstack and sign in. Add --scope user to use it in every project. You can also install it as a plugin:

/plugin marketplace add atomicvan/pingstack-mcp/plugin install pingstack@pingstack

Claude (claude.ai and Claude Desktop)

Go to Settings → Connectors, choose Add custom connector, name it Pingstack and enter https://app.pingstack.io/mcp.

GitHub Copilot CLI

copilot mcp add --transport http pingstack https://app.pingstack.io/mcp

If /mcp shows needs-auth, run /mcp auth pingstack.

VS Code with Copilot

Run MCP: Add Server from the Command Palette, choose HTTP and enter the URL. Or add it to .vscode/mcp.json:

{  "servers": {    "pingstack": {      "type": "http",      "url": "https://app.pingstack.io/mcp"    }  }}

Cursor

Add this to ~/.cursor/mcp.json, then sign in from Cursor's MCP settings:

{  "mcpServers": {    "pingstack": {      "url": "https://app.pingstack.io/mcp"    }  }}

OpenAI Codex

codex mcp add pingstack --url https://app.pingstack.io/mcpcodex mcp login pingstack

Google Antigravity

Install the plugin in the antigravity folder with the Antigravity CLI. The app picks it up too. You sign in in the browser the first time it connects:

git clone https://github.com/atomicvan/pingstack-mcpagy plugin install ./pingstack-mcp/antigravity

Or add this to ~/.gemini/config/mcp_config.json, then click Authenticate next to pingstack under Agent settings → Customizations:

{  "mcpServers": {    "pingstack": {      "serverUrl": "https://app.pingstack.io/mcp"    }  }}

Gemini CLI

Install it as an extension:

gemini extensions install https://github.com/atomicvan/pingstack-mcp

Then run /mcp auth pingstack.

The client setup guide covers each client in more detail, plus how to use an API key when your client can't sign in through a browser.

Tools

The server has 20 tools. Your client only sees the ones the connection has permission for.

History goes back as far as your plan keeps it. See the tool reference for every argument.

What it won't do

The server can't delete anything, publish a status page, manage custom domains, pause checks, post incident updates or buy anything. Those stay in the Pingstack app. Every connection is limited to one account, to the permissions approved when it was connected, and to the approving person's current role. At a plan limit it tells your agent the limit and returns an upgrade link for a person to open.

Heartbeat ping URLs let anyone report a job as done, so the server only returns them when you tick that permission while connecting.

Example prompts

• Add a daily heartbeat for the backup job with a 15 minute grace period and put it on the Infrastructure dashboard.
• Which checks had incidents in the last 7 days, and how long were they down?
• Create website and SSL certificate checks for every domain in this README.
• What's the p95 latency for the API check over the last 30 days?
• How many checks do I have left on my plan?

Support

• Docs: docs.pingstack.io
• Email: [email protected]
• Privacy policy: pingstack.io/privacy-policy
• Terms: pingstack.io/terms-conditions

Please report security issues to [email protected] rather than opening a public issue.

License

The files in this repository are under the MIT License. The Pingstack service is covered by its terms.