MCP server for Internet Telemetry - query real-time internet outages, network reachability, and speed test data with AI assistants like Claude
npm install @internet-telemetry/mcp-server

A Model Context Protocol (MCP) server that enables AI assistants like Claude to query real-time internet outage data, network reachability, and speed test results.
- Real-time Outage Data: Query internet outages from multiple sources (ODIN, Cloudflare Radar, NWS, Cal OES)
- Network Reachability: Check the status of major DNS providers and network endpoints
- Speed Test History: Access your speed test results and trends
- Natural Language Queries: Ask Claude about outages in plain English
``bash`
npm install -g @internet-telemetry/mcp-server
Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):
`json`
{
"mcpServers": {
"internet-telemetry": {
"command": "npx",
"args": ["-y", "@internet-telemetry/mcp-server"]
}
}
}
Add to .mcp.json in your project or ~/.claude/mcp.json globally:
`json`
{
"mcpServers": {
"internet-telemetry": {
"command": "npx",
"args": ["-y", "@internet-telemetry/mcp-server"]
}
}
}
| Tool | Description |
|------|-------------|
| get_incidents | Get recent internet outages and incidents |search_incidents
| | Search incidents by keyword |get_outages
| | Get unified outage data with ISP attribution |search_outages
| | Search outages by keyword |get_reachability
| | Check network reachability for monitored targets |get_speedtest_history
| | Get your speed test history |get_speedtest_info
| | Get speed test server and connection info |
Once configured, you can ask Claude:
- "Are there any internet outages in California right now?"
- "What's the reachability status of Google DNS?"
- "Show me incidents affecting Comcast in the last 24 hours"
- "How has my internet speed been trending this week?"
``
Parameters:
- hours: number (default: 24, max: 168)
- source: "odin" | "radar" | "nws" | "caloes"
- state: US state code (e.g., "CA")
- min_severity: 1-5
``
Parameters:
- query: string (required)
- hours: number (default: 24)
- limit: number (default: 50)
``
Parameters:
- hours: number (default: 24)
- isp: ISP name filter
- state: US state code
- active_only: boolean
``
Parameters:
- target: string (e.g., "cloudflare-dns", "google-dns")
- hours: number (default: 1)
``
Parameters:
- limit: number (default: 20, max: 100)
The server also provides MCP resources:
- ods://schema/incident - JSON schema for incident objectsods://info/data-sources
- - Available data sources and update frequencies
Pre-built prompts for common tasks:
- analyze_outage - Detailed analysis of a specific outagesummarize_incidents
- - Summary of recent incidents
`bashClone the repository
git clone https://github.com/internet-telemetry/outage-detection-system.git
cd outage-detection-system/packages/mcp-server
API
This MCP server connects to the Internet Telemetry API at
https://ods-api.m-8b1.workers.dev`. For direct API access, see the API documentation.- Node.js 18+
- A compatible MCP client (Claude Desktop, Claude Code, or other MCP-enabled applications)
MIT
- Documentation
- API Reference
- GitHub Repository
- Internet Telemetry Dashboard