How do I use earthquake-mcp-server?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@earthquake-mcp-server Show me earthquakes in the last 24 hours with magnitude 4.0+" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

earthquake-mcp-server

by AiAgentKarl

Overview Schema Source Related Servers Discussions Admin

Python

Remote

earthquake-mcp-server

PyPI version License: MIT Python 3.10+

Real-time earthquake data and seismic monitoring for AI agents via the USGS Earthquake Catalog API. No API key required — all data is open and free.

Features

Real-time data from the USGS Earthquake Hazards Program
No API key needed — fully open data
Global coverage — all earthquakes worldwide
Tsunami warnings, felt reports, and PAGER alert levels
Magnitude filtering, date ranges, and radius search
Historical data going back decades

Related MCP server: usgs-earthquakes

Tools

Tool	Description
`tool_get_recent_earthquakes`	Recent earthquakes (last N hours), filtered by magnitude
`tool_search_earthquakes`	Search by date range and magnitude
`tool_get_significant_earthquakes`	Major earthquakes (M5.0+) sorted by magnitude
`tool_earthquakes_near_location`	Earthquakes within a radius of lat/lon coordinates
`tool_get_seismic_summary`	24h global seismic activity summary with statistics
`tool_get_earthquake_count`	Count earthquakes in a time range
`tool_get_largest_earthquakes`	Top N largest earthquakes in the last N years
`tool_get_magnitude_info`	Educational: Moment Magnitude Scale explained

Installation

pip install earthquake-mcp-server

Usage with Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "earthquake": {
      "command": "earthquake-mcp-server"
    }
  }
}

Example Queries

"Show me all earthquakes in the last 24 hours with magnitude 4.0+"
"Were there any significant earthquakes near Japan this week?"
"What is the seismic activity summary for today?"
"Find earthquakes near coordinates 35.6°N, 139.7°E (Tokyo) in the last 30 days"
"What are the 10 largest earthquakes in the last year?"
"How strong was the strongest earthquake this month?"

Data Source

All data comes from the USGS Earthquake Catalog API, maintained by the U.S. Geological Survey. Data is real-time and updated continuously.

License

MIT License — see LICENSE

space-mcp-server — NASA space data
climate-risk-mcp-server — Climate & ESG data
geospatial-mcp-server — OpenStreetMap & geospatial tools

Available Tools

8 tools

tool_earthquakes_near_locationB

Erdbeben in der Naehe eines Ortes (Koordinaten) abrufen.

Name	Required	Description
`days`	No	Zeitraum in Tagen (Standard: 30)
`limit`	No	Maximale Anzahl Ergebnisse (Standard: 20, max: 100)
`latitude`	Yes	Breitengrad (-90 bis 90)
`longitude`	Yes	Laengengrad (-180 bis 180)
`radius_km`	No	Suchradius in Kilometern (Standard: 200 km)
`min_magnitude`	No	Minimale Magnitude (Standard: 2.0)

Output Schema

Name	Required	Description
No output parameters

tool_get_earthquake_countB

Anzahl der Erdbeben fuer einen Zeitraum abrufen.

Name	Required	Description
`end_date`	No	Enddatum (Format: YYYY-MM-DD)
`start_date`	Yes	Startdatum (Format: YYYY-MM-DD)
`min_magnitude`	No	Minimale Magnitude

Output Schema

Name	Required	Description
No output parameters

tool_get_largest_earthquakesC

Die groessten Erdbeben der letzten Jahre abrufen.

Name	Required	Description	Default
`limit`	No	Anzahl der Ergebnisse (Standard: 10, max: 50)
`years`	No	Zeitraum in Jahren (Standard: 1, max: 10)

Output Schema

Name	Required	Description
No output parameters

tool_get_magnitude_infoA

Erklaerung der Richter-Skala und Magnitudenklassen abrufen. Bildungsinhalt zur Interpretation von Erdbebenstaerken.

Returns: Erklaerung der Magnitudenklassen und ihrer Auswirkungen

Name	Required	Description	Default
No parameters

Output Schema

Name	Required	Description
No output parameters

tool_get_recent_earthquakesB

Aktuelle Erdbeben der letzten N Stunden abrufen.

Name	Required	Description
`hours`	No	Zeitraum in Stunden (Standard: 24, max: 168)
`limit`	No	Maximale Anzahl Ergebnisse (Standard: 20, max: 100)
`min_magnitude`	No	Minimale Magnitude (Standard: 2.5)

Output Schema

Name	Required	Description
No output parameters

tool_get_seismic_summaryA

Seismische Zusammenfassung der letzten 24 Stunden abrufen. Zeigt Aktivitaetsniveaus nach Magnitudenklasse.

Returns: Statistik-Uebersicht der globalen seismischen Aktivitaet

Name	Required	Description	Default
No parameters

Output Schema

Name	Required	Description
No output parameters

tool_get_significant_earthquakesC

Bedeutende/starke Erdbeben der letzten N Tage abrufen.

Name	Required	Description
`days`	No	Zeitraum in Tagen (Standard: 30, max: 365)
`limit`	No	Maximale Anzahl Ergebnisse (Standard: 20, max: 100)
`min_magnitude`	No	Minimale Magnitude (Standard: 5.0)

Output Schema

Name	Required	Description
No output parameters

tool_search_earthquakesB

Erdbeben nach Datum und Magnitude suchen.

Name	Required	Description
`limit`	No	Maximale Anzahl Ergebnisse (Standard: 20, max: 100)
`region`	No	Beschreibungstext zur Region (fuer die Ausgabe, nicht API-Filter)
`end_date`	No	Enddatum (Format: YYYY-MM-DD, Standard: heute)
`start_date`	Yes	Startdatum (Format: YYYY-MM-DD)
`max_magnitude`	No	Maximale Magnitude
`min_magnitude`	No	Minimale Magnitude

Output Schema

Name	Required	Description
No output parameters

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

8 tool updatesv0.1.0Aug 7, 2026
- First observedtool_earthquakes_near_location
- First observedtool_get_earthquake_count
- First observedtool_get_largest_earthquakes
- First observedtool_get_magnitude_info
- First observedtool_get_recent_earthquakes
- First observedtool_get_seismic_summary
- First observedtool_get_significant_earthquakes
- First observedtool_search_earthquakes

Deploy Server

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

A3.5/5.0

Scored 2026-08-07 08:05 across 8 tools

Disambiguation4/5

Most tools have distinct purposes: recent, search, significant, largest, near location, summary, count, and educational info. However, recent, search, and significant all return earthquake lists, and their boundaries could be clearer, though descriptions help differentiate time frames and filters.

Naming Consistency4/5

The naming pattern is mostly consistent with a 'tool_' prefix and a verb_noun structure (e.g., get_recent_earthquakes, search_earthquakes). One outlier is 'earthquakes_near_location' which lacks a leading verb, breaking the pattern slightly.

Tool Count5/5

With 8 tools, the server is well-scoped for an earthquake information service. Each tool covers a distinct query type without overwhelming the user, and there is no redundancy or unnecessary bloat.

Completeness4/5

The tool set covers common earthquake queries: recent, search, significant, largest, near location, summary, count, and educational info. Minor gaps include lack of a tool to fetch details for a specific earthquake by ID, but the current surface is functionally complete for most use cases.

Maintenance

ActivityInactive

ResponsivenessNo recent community issues

Resources

Related MCP Connectors

USGS EarthquakesA
com.olyport
Real-time earthquake events from the US Geological Survey
Government Data Open Data Search
32
https://mcp.olyport.com/earthquake/mcp
USGS Real-Time Seismic & Earthquake Hazard FeedC
io.ceadigital
Query official USGS real-time earthquake events, magnitudes, and seismic hazard telemetry.
Government Data Open Data Research & Data
281
https://ceadigital.io/mcp/usgs
earthquake-mcp-serverA
io.github.cyanheads
Search USGS and EMSC seismic data — real-time feeds, event queries, and earthquake counts.
Government Data Open Data
423
https://earthquake.caseyjhand.com/mcp
Weather & Geo Intel MCPA
io.github.selflabbs
US weather & geo for AI agents: forecasts, alerts, earthquakes, elevation, geocoding. No keys.
Weather Services Location Services
2
https://weather.selflabbs.com/mcp

Related MCP Servers

Comprehensive Earthquake
Research & Data Open Data Government Data
ruby0606
A
license
Not graded
quality
D
maintenance
Integrates multiple earthquake data sources (IRIS, USGS, GNSS) for comprehensive seismic monitoring, analysis, and risk assessment via natural language queries.
Updated a year ago (2025-08-17 23:55 UTC)
1
MIT
usgs-earthquakes
Government Data Open Data
pipeworx-io
A
license
Not graded
quality
C
maintenance
Provides access to the USGS Earthquake Catalog for querying earthquake events via the FDSNWS API, enabling natural language questions about earthquake data.
Updated 4 days ago (2026-11-06 01:58 UTC)
302 npm
MIT
geo-agent
Government Data Open Data
KavyaAgarwal2001
F
license
A
quality
D
maintenance
Exposes live earth-science data (e.g., earthquakes from USGS) as tools for MCP-compatible AI agents, enabling them to fetch and reason about real-time geophysical events.
Updated 5 months ago (2026-06-19 20:23 UTC)
1
-
EmergencyOps MCP Server
jdbruh18
A
license
Not graded
quality
D
maintenance
Enables LLM agents to access live seismic data, calculate emergency vehicle routes, and dispatch first responders to incidents.
Updated 4 months ago (2026-07-21 18:48 UTC)
MIT

earthquake-mcp-server

Features

Tools

Installation

Usage with Claude Desktop

Example Queries

Data Source

License

Related MCP Servers

Available Tools

Output Schema

Output Schema

Output Schema

Output Schema

Output Schema

Output Schema

Output Schema

Output Schema

Tool Schema Changelog

TDQS

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

Comprehensive Earthquake

usgs-earthquakes

geo-agent

EmergencyOps MCP Server