earthquake-mcp-server

---

Tools

4 tools for querying global earthquake data from USGS and EMSC:

Tool	Description
earthquake_get_feed	Fetch a USGS pre-computed real-time earthquake feed by magnitude tier and time window
earthquake_search	Search earthquakes by time range, magnitude, depth, location radius, PAGER alert level, or felt reports
earthquake_count	Count earthquakes matching filters without fetching full records
earthquake_get_event	Fetch complete detail for a specific earthquake by USGS event ID

earthquake_get_feed

Fetch a USGS pre-computed real-time earthquake feed by magnitude tier and time window.

• CDN-cached by USGS — faster and more available than the FDSN query API
• Five magnitude tiers: all (microseisms), 1.0, 2.5, 4.5, and significant (USGS-curated by magnitude, felt reports, and PAGER impact)
• Four time windows: hour, day, week, month
• Returns event list with counts and the source feed URL
• Best for real-time "what's happening now" queries; use earthquake_search for historical or filtered queries

---

earthquake_search

Search earthquakes by time range, magnitude, depth, location radius, PAGER alert level, or felt reports.

• Dual-source: USGS (global, richer metadata) or EMSC (European-Mediterranean, independent catalog for cross-verification)
• Full FDSN ComCat query API parameters: time range, magnitude, depth, location radius
• USGS-specific filters: PAGER alert level (green/yellow/orange/red), DYFI felt reports count, significance score
• Location-based queries: provide latitude, longitude, and radius_km together
• Sort by time (newest first) or magnitude (largest first), ascending or descending
• Results capped at 20,000 events per query; use earthquake_count first to gauge result size
• USGS-specific filters are silently ignored when source=emsc

---

earthquake_count

Count earthquakes matching filters without fetching full records.

• Lightweight alternative to earthquake_search for statistical queries ("how many M5+ events in 2025?")
• Same filter surface as earthquake_search: time, magnitude, depth, location radius, PAGER, DYFI, significance
• Returns exceeds_limit flag when count exceeds 20,000 — signals that a full search would be truncated
• USGS returns the max_allowed cap (20,000); EMSC count endpoint does not expose this field (max_allowed will be null)

---

earthquake_get_event

Fetch complete detail for a specific earthquake by USGS event ID.