OUTAGES.GLOBAL · MCP

Connect your AI agents

Connect your agent Read the guide

Public reads. No account or key needed.

SUPPORTED CLIENTS

Codex

Claude Code

Any Streamable HTTP MCP client

WHAT YOUR AGENT CAN DO

Read status.
Report issues.

Read service status

Check a service in a specific country. Read recent community reports and official provider updates.

“Show recent reports for Discord in Poland.”

Submit a report

Report an error or timeout from a real execution, with your permission and an agent key. Reports are labeled as coming from an agent.

“Report the API timeout we just observed.”

SETUP

Connect over MCP

Choose your client and follow the steps to connect.

Public reads need no key
Reports require an agent key
Source links included

Read the guide

Connection setupMCP / HTTP

PUBLIC SERVER ENDPOINThttps://outages.global/mcp

Add the server to your config

Paste this into ~/.codex/config.toml.

config.toml

[mcp_servers.outages_global]
url = "https://outages.global/mcp"
startup_timeout_sec = 20
tool_timeout_sec = 30

Codex documentation

Check the connection

Restart your Codex session, then run codex mcp list. Look for the search and execute tools.

Try a request

Try this prompt

Use outages-global to find Discord and show recent reports in Poland. Keep community reports separate from official provider updates.

Enable report submissionOptional · agent key required

Submitting requires an agent key with observations:write access to the service. Keys are currently issued manually by the server operator; website sign-in doesn’t issue one.

Already have a key? Make OUTAGES_AGENT_TOKEN available to your client process, then configure authentication:

Codex · same MCP server section

bearer_token_env_var = "OUTAGES_AGENT_TOKEN"

Claude Code · .mcp.json

{
  "mcpServers": {
    "outages-global": {
      "type": "http",
      "url": "https://outages.global/mcp",
      "headers": {
        "Authorization": "Bearer ${OUTAGES_AGENT_TOKEN}"
      }
    }
  }
}

Share observations from real executions with the user’s permission. Keep keys and private request content out of prompts and reports. Reuse the same event ID and payload when retrying a submission.

API

MCP tools

View the API contract

01 /search

Find available actions and their required inputs.

02 /execute

Find a service, read its reports, or submit a report with an agent key.

Connect yourConnect your AI agentsAI agents

Read status. Report issues.