MCP Server

Give Claude, ChatGPT, or any MCP client live vendor status. Four tools are open with no account, no key, and no signup.

PulsAPI publishes a Model Context Protocol server so an AI agent can check whether a vendor is down instead of guessing from stale training data.

Four tools are open to anyone. No account, no API key, no signup.

What an agent can ask without an account

Tool	Answers
`list_services`	Which vendors PulsAPI tracks, filterable by category and status
`get_service_status`	Whether one vendor is up right now
`get_component_status`	Which part of a vendor is affected, and in which region
`list_incidents`	Open and recent incidents

get_uptime_report aggregates 90 days of history and needs a plan. Ask for it anonymously and the server replies with which tools you can use and where to get the rest, rather than a bare rejection.

Anonymous callers get 60 requests per hour. The bucket is keyed on a SHA-256 digest of your address — we rate-limit you without storing where you called from.

Connect it

Claude Desktop

Add this to claude_desktop_config.json, then restart the app:

{
  "mcpServers": {
    "pulsapi": {
      "url": "https://www.pulsapi.com/api/mcp"
    }
  }
}

Any MCP client

Point the client at the base URL. Discovery and invocation are two plain HTTP calls:

GET  https://www.pulsapi.com/api/mcp/tools
POST https://www.pulsapi.com/api/mcp/invoke

/tools returns only the tools your credentials entitle you to, so an agent never sees a tool it cannot call. The response carries a tier field — anonymous or authenticated.

curl

curl -s https://www.pulsapi.com/api/mcp/tools

curl -s https://www.pulsapi.com/api/mcp/invoke \
  -H 'Content-Type: application/json' \
  -d '{"tool":"get_service_status","input":{"slug":"cloudflare"}}'

Authenticating for the full set

Send a PulsAPI API key to unlock every tool and drop the anonymous rate limit:

curl -s https://www.pulsapi.com/api/mcp/tools \
  -H 'X-API-Key: pb_your_key_here'

API keys live in Settings → API Keys. MCP server access is an Enterprise feature; see pricing.

Worked example

Asking an agent "is Cloudflare having problems, and does it affect eu-west?" turns into get_service_status for the headline and get_component_status for the regional breakdown. The second call is the one that matters: most vendors publish a component breakdown, but only about a quarter of them say which region is affected — see the Status Page Transparency Report for the measured numbers.

Limits worth knowing

Anonymous access is read-only public status data — the same information the website serves to anyone. There is no customer or workspace data behind it.
Results reflect what each vendor publishes. Where a vendor publishes nothing parseable, PulsAPI falls back to a direct reachability check, which is a weaker global up/down signal rather than per-component detail.
The rate limit is per hour and applies to discovery as well as invocation.

On this page