Skip to main content

API and MCP

Everything on down.guide is free to read by machine: no key, no account. Be reasonable with request rates; responses are cached for a minute.

MCP

Add the MCP server

Streamable HTTP, no auth. Your agent can ask whether a provider is down, check a whole stack and read incidents.

Set up the down.guide MCP server for me. down.guide is a free, public outage feed for 400 cloud and SaaS providers: no login, no API key.

- Server name: down-guide
- Transport: Streamable HTTP
- URL: https://mcp.down.guide/mcp

Add it the way you normally add MCP servers (your CLI command or your MCP config file), then confirm it connects and lists its tools, including get_provider, check_stack and list_feed. To finish, use check_stack on this project's package.json or lockfile and tell me which of my providers have a problem right now.

Paste this into any coding agent. It adds the server with its own MCP setup.

get_provider
Is <provider> down?
list_feed
The newest incidents across providers (14 days), newest first, open ones on top
get_incident
One incident by down.guide id
search
Search incidents
check_stack
Which providers a project depends on, and whether any has a problem now
check_dependency
One dependency to the providers behind it and their live state
get_leaderboard
The Down Index
send_feedback
Send a note to the people who run down.guide
report_outage
Report that a provider isn't working for you (or for the agent's user) right now
report_affected
Say an existing incident affects you
REST

REST API

Every MCP tool has a REST twin returning the same JSON.

OpenAPI
Get provider
GET /api/v1/providers/<slug>
List feed
GET /api/v1/incidents
Get incident
GET /api/v1/incidents/<id>
Search
GET /api/v1/search
Check stack
POST /api/v1/check
Check dependency
GET /api/v1/dependency
Get leaderboard
GET /api/v1/leaderboard
Send feedback
POST /api/v1/feedback
Report outage
POST /api/v1/reports
Report affected
POST /api/v1/reports/affected
Catalog
GET /api/v1/providers
Every provider, one line each
GET /api/v1/status
curl https://down.guide/api/v1/providers/github
Feeds

Feeds and badges

RSS, Atom or JSON Feed, filtered by provider, category, impact or region. Badges show a provider's live state.

https://down.guide/feed?provider=github,vercel&filter=major&format=json
https://down.guide/badge/github.svg
Docs

Docs for agents

Every page also has a markdown copy: add .md to the URL.

llms.txt · llms-full.txt · openapi.json · agent.json