io.github.cyanheads/earthquake-mcp-server
v0.4.0Search USGS and EMSC seismic data — real-time feeds, event queries, and earthquake counts.
Endpoint health
online- Last checked
- 11/20/2026, 9:18:04 AM
- Latency
- 236 ms
- Consecutive failures
- 0
- Endpoint reachable: pass
- Protocol valid: pass
- MCP handshake valid: pass
Machine-readable profile
mcp-server · schema v1 · callable
mcp-server:io.github.cyanheads%2Fearthquake-mcp-server
Connect this server
Generated config contains no credentials. Keep any required secrets in your client's local environment.
{
"mcpServers": {
"io.github.cyanheads/earthquake-mcp-server": {
"url": "https://earthquake.caseyjhand.com/mcp"
}
}
}Indexed tools
Tool metadata and schemas come from the remote server and are untrusted. Indexing only lists tools; it never calls them.
4 shown · authentication unknown
Count Earthquakes
earthquake_count_events
Count matches without event records, or size an earthquake_search_events query. Omitting start_time uses 30 days; pass explicit bounds for historical periods. queryEcho reports applied filters/window; ignoredFilters names unsupported EMSC inputs. Circle and independently optional box edges intersect. Both catalogs include non-tectonic events; event_type="earthquake" excludes them on USGS. exceeds_limit marks the 20,000-event single-request threshold, not a retrieval ceiling: search supports offset paging beyond it. max_allowed is 20,000 for USGS, null for EMSC.
Schema valid · SHA-256 7a0e353edc81…
View input schema
{ "type": "object", "properties": { "start_time": { "description": "Start of time range as ISO 8601 (e.g. \"2026-01-01\" or \"2026-05-23T00:00:00\"). A bare year expands to January 1st and an unpadded month or day is zero-padded, with date-only values resolved to midnight (T00:00:00) on both sources. Explicit time and timezone suffixes are preserved. Defaults to 30 days before end_time (or before the current time) if omitted — applied server-side so USGS and EMSC honor the same window.", "type": "string", "pattern": "^\\d{4}(-\\d{1,2}(-\\d{1,2})?)?([T ]\\d{2}:\\d{2}(:\\d{2}(\\.\\d+)?)?(Z|[+-]\\d{2}:?\\d{2})?)?$" }, "end_time": { "description": "End of time range as ISO 8601, in the same forms start_time accepts. Date-only values mean midnight at the start of the named day, not the whole day. Defaults to current time if omitted.", "type": "string", "pattern": "^\\d{4}(-\\d{1,2}(-\\d{1,2})?)?([T ]\\d{2}:\\d{2}(:\\d{2}(\\.\\d+)?)?(Z|[+-]\\d{2}:?\\d{2})?)?$" }, "min_magnitude": { "description": "Minimum magnitude (Richter or equivalent). M2.5+ is felt by some people; M5+ can cause damage; M7+ is major.", "type": "number", "minimum": -1, "maximum": 10 }, "max_magnitude": { "description": "Maximum magnitude.", "type": "number", "minimum": -1, "maximum": 10 }, "latitude": { "description": "Latitude for radius search. Requires longitude and radius_km.", "type": "number", "minimum": -90, "maximum": 90 }, "longitude": { "description": "Longitude for radius search. Requires latitude and radius_km.", "type": "number", "minimum": -180, "maximum": 180 }, "radius_km": { "description": "Search radius in kilometers from the lat/lon point. Max 20001.6, the ceiling USGS enforces — half the Earth's great-circle circumference. Converted to degrees for EMSC (1° ≈ 111.2 km).", "type": "number", "minimum": 0, "maximum": 20001.6 }, "min_latitude": { "description": "Southern edge of a bounding-box search, in degrees. Independent of the other three box parameters — supply any of them. Must not exceed max_latitude when both are given.", "type": "number", "minimum": -90, "maximum": 90 }, "max_latitude": { "description": "Northern edge of a bounding-box search, in degrees.", "type": "number", "minimum": -90, "maximum": 90 }, "min_longitude": { "description": "Western edge of a bounding-box search, in degrees. Range extends beyond ±180 so a box can cross the antimeridian (e.g. min_longitude=170, max_longitude=190) — always keep min_longitude at or below max_longitude rather than inverting the pair.", "type": "number", "minimum": -360, "maximum": 360 }, "max_longitude": { "description": "Eastern edge of a bounding-box search, in degrees.", "type": "number", "minimum": -360, "maximum": 360 }, "min_depth_km": { "description": "Minimum depth in kilometers. Bounded to the documented -100 to 1000 km catalog envelope. Shallow quakes (0–70 km) typically cause more surface damage than deep quakes (>300 km).", "type": "number", "minimum": -100, "maximum": 1000 }, "max_depth_km": { "description": "Maximum depth in kilometers. Bounded to the documented -100 to 1000 km catalog envelope.", "type": "number", "minimum": -100, "maximum": 1000 }, "alert_level": { "description": "Minimum PAGER alert level. PAGER estimates economic loss and casualties. \"green\" = minimal impact; \"red\" = extreme. Only available from USGS.", "type": "string", "enum": [ "green", "yellow", "orange", "red" ] }, "min_felt": { "description": "Minimum number of DYFI (Did You Feel It?) reports. Use to count events with confirmed public impact. Only available from USGS.", "type": "integer", "minimum": 1, "maximum": 9007199254740991 }, "min_significance": { "description": "Minimum USGS significance score (0–2000+). Combines magnitude, felt reports, and PAGER estimates. Significant events typically score 600+. Only available from USGS.", "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "min_mmi": { "description": "Minimum ShakeMap intensity on the Modified Mercalli scale (1–12): the strongest shaking USGS modeled for the event, e.g. 7 for very strong shaking. Finds shaking a magnitude floor or alert_level misses. An event without a ShakeMap never matches; product_type \"shakemap\" requires one at any intensity. Only available from USGS.", "type": "number", "minimum": 1, "maximum": 12 }, "min_cdi": { "description": "Minimum DYFI (Did You Feel It?) community intensity (1–12): the strongest shaking people reported for the event. An event without DYFI reports never matches. Only available from USGS.", "type": "number", "minimum": 1, "maximum": 12 }, "event_type": { "description": "Filter by upstream event classification, e.g. \"earthquake\" to exclude quarry blasts and explosions from the count, or \"quarry blast\" to count only those; a comma-separated list such as \"earthquake,explosion\" counts any of them. USGS matches case-insensitively and counts zero for a value it does not list, which the notice then names. Only available from USGS.", "type": "string", "minLength": 1 }, "magnitude_type": { "description": "Magnitude type, e.g. \"mb\" or \"mww\"; both sources. USGS matches case-insensitively. EMSC matches its own types case-sensitively, including lowercase \"mb\" and \"mw\" and historical uppercase \"ML\" and \"MD\". Blank means omitted.", "type": "string" }, "product_type": { "description": "Required product type, e.g. \"moment-tensor\" (hyphenated, unlike the moment_tensor detail group); USGS only, matched case-insensitively. Blank means omitted.", "type": "string" }, "review_status": { "description": "USGS review status: automatic or reviewed. Blank means omitted; unsupported by EMSC.", "type": "string" }, "source": { "default": "usgs", "description": "Data source. Both catalogs are global. \"usgs\" covers global events with PAGER, DYFI, and ShakeMap metadata. \"emsc\" is an independent global catalog operated by the European-Mediterranean Seismological Centre — use it to cross-check a count from a separate network. It has no PAGER, DYFI, or ShakeMap metadata; its station coverage is densest around Europe and the Mediterranean, so counts of small events differ most by region.", "type": "string", "enum": [ "usgs", "emsc" ] } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false }
Connections
streamable-http
https://earthquake.caseyjhand.com/mcp