# earthquake-mcp-server MCP server

Search USGS and EMSC seismic data — real-time feeds, event queries, and earthquake counts.

## Links
- Registry page: https://www.getdrio.com/mcp/io-github-cyanheads-earthquake-mcp-server
- Repository: https://github.com/cyanheads/earthquake-mcp-server

## Install
- Command: `npx -y @cyanheads/earthquake-mcp-server`
- Endpoint: https://earthquake.caseyjhand.com/mcp
- Auth: Not captured

## Setup notes
- Package: Npm @cyanheads/earthquake-mcp-server v0.1.6
- Environment variable: MCP_LOG_LEVEL (default info)
- Package: Npm @cyanheads/earthquake-mcp-server v0.1.6
- Environment variable: MCP_HTTP_HOST (default 127.0.0.1)
- Environment variable: MCP_HTTP_PORT (default 3010)
- Environment variable: MCP_HTTP_ENDPOINT_PATH (default /mcp)
- Environment variable: MCP_AUTH_MODE (default none)
- Environment variable: MCP_LOG_LEVEL (default info)
- Remote endpoint: https://earthquake.caseyjhand.com/mcp

## Tools
- earthquake_get_feed (Get USGS Earthquake Feed) - Fetch a USGS pre-computed real-time earthquake feed by magnitude tier and time window. These feeds are CDN-cached by USGS and faster and more available than the query API — use them for "what's happening now" queries. "all" includes microseisms (M<1); "significant" is a USGS curation based on magnitude, felt reports, and PAGER impact estimates. "hour" returns 0–10 events typically; "month" can exceed 10,000 for the "all" tier. For historical or filtered queries, use earthquake_search instead. Endpoint: https://earthquake.caseyjhand.com/mcp
- earthquake_search (Search Earthquakes) - Search earthquakes by time range, magnitude, depth, location radius, PAGER alert level, or felt reports. Supports USGS (global, richer metadata: PAGER, DYFI, ShakeMap) and EMSC (European-Mediterranean, independent catalog). For location-based queries, provide latitude, longitude, and radius_km together. USGS-specific filters (alert_level, min_felt, min_significance) are ignored when source=emsc. Use earthquake_count first to gauge result size before requesting large result sets. Results are capped at 20,000 events per query. Endpoint: https://earthquake.caseyjhand.com/mcp
- earthquake_get_event (Get Earthquake Event Detail) - Fetch complete detail for a specific earthquake by USGS event ID. Returns the full property set including felt reports count (DYFI), ShakeMap maximum intensity (MMI), PAGER alert level, tsunami flag, and magnitude type. Event IDs appear in the "id" field of earthquake_get_feed and earthquake_search results. This tool is USGS-only — EMSC events have no per-event detail endpoint. Endpoint: https://earthquake.caseyjhand.com/mcp
- earthquake_count (Count Earthquakes) - Count earthquakes matching filters without fetching full records. Use for statistical queries ("how many M5+ earthquakes in 2025?") or to gauge result size before calling earthquake_search. When exceeds_limit is true, the count exceeds 20,000 and a full search would be truncated — narrow filters before fetching. USGS returns the max_allowed cap (20,000); EMSC count endpoint does not return this field (max_allowed will be null). USGS-specific filters (alert_level, min_felt, min_significance) are ignored when source=emsc. Endpoint: https://earthquake.caseyjhand.com/mcp

## Resources
- earthquake://feed/all/hour - USGS Earthquake Feed USGS real-time feed: all events in the last hour. MIME type: application/json
- earthquake://feed/all/day - USGS Earthquake Feed USGS real-time feed: all events in the last day. MIME type: application/json
- earthquake://feed/all/week - USGS Earthquake Feed USGS real-time feed: all events in the last week. MIME type: application/json
- earthquake://feed/all/month - USGS Earthquake Feed USGS real-time feed: all events in the last month. MIME type: application/json
- earthquake://feed/1.0/hour - USGS Earthquake Feed USGS real-time feed: M1.0+ events in the last hour. MIME type: application/json
- earthquake://feed/1.0/day - USGS Earthquake Feed USGS real-time feed: M1.0+ events in the last day. MIME type: application/json
- earthquake://feed/1.0/week - USGS Earthquake Feed USGS real-time feed: M1.0+ events in the last week. MIME type: application/json
- earthquake://feed/1.0/month - USGS Earthquake Feed USGS real-time feed: M1.0+ events in the last month. MIME type: application/json
- earthquake://feed/2.5/hour - USGS Earthquake Feed USGS real-time feed: M2.5+ events in the last hour. MIME type: application/json
- earthquake://feed/2.5/day - USGS Earthquake Feed USGS real-time feed: M2.5+ events in the last day. MIME type: application/json
- earthquake://feed/2.5/week - USGS Earthquake Feed USGS real-time feed: M2.5+ events in the last week. MIME type: application/json
- earthquake://feed/2.5/month - USGS Earthquake Feed USGS real-time feed: M2.5+ events in the last month. MIME type: application/json
- earthquake://feed/4.5/hour - USGS Earthquake Feed USGS real-time feed: M4.5+ events in the last hour. MIME type: application/json
- earthquake://feed/4.5/day - USGS Earthquake Feed USGS real-time feed: M4.5+ events in the last day. MIME type: application/json
- earthquake://feed/4.5/week - USGS Earthquake Feed USGS real-time feed: M4.5+ events in the last week. MIME type: application/json
- earthquake://feed/4.5/month - USGS Earthquake Feed USGS real-time feed: M4.5+ events in the last month. MIME type: application/json
- earthquake://feed/significant/hour - USGS Earthquake Feed USGS real-time feed: significant events in the last hour. MIME type: application/json
- earthquake://feed/significant/day - USGS Earthquake Feed USGS real-time feed: significant events in the last day. MIME type: application/json
- earthquake://feed/significant/week - USGS Earthquake Feed USGS real-time feed: significant events in the last week. MIME type: application/json
- earthquake://feed/significant/month - USGS Earthquake Feed USGS real-time feed: significant events in the last month. MIME type: application/json

## Prompts
Not captured

## Metadata
- Owner: io.github.cyanheads
- Version: 0.1.6
- Runtime: Npm
- Transports: STDIO, HTTP
- License: Not captured
- Language: Not captured
- Stars: Not captured
- Updated: May 24, 2026
- Source: https://registry.modelcontextprotocol.io