MCP Server for real-time earthquake data and seismic monitoring via USGS Earthquake Catalog API
Project description
earthquake-mcp-server
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
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
Related MCP Servers
- space-mcp-server — NASA space data
- climate-risk-mcp-server — Climate & ESG data
- geospatial-mcp-server — OpenStreetMap & geospatial tools
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file earthquake_mcp_server-0.1.0.tar.gz.
File metadata
- Download URL: earthquake_mcp_server-0.1.0.tar.gz
- Upload date:
- Size: 7.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.13.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
c7fa1aa9a811de73d2098ccab60217908d00c46ad397475a20882f57d2282780
|
|
| MD5 |
f5f79a21fc1b92530a7a4d3a3a96fc25
|
|
| BLAKE2b-256 |
095453dc724ebda8542669772d954f3ceb4c7413c80cb05318f15917b7a65577
|
File details
Details for the file earthquake_mcp_server-0.1.0-py3-none-any.whl.
File metadata
- Download URL: earthquake_mcp_server-0.1.0-py3-none-any.whl
- Upload date:
- Size: 9.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.13.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
94fb070717172e4bed2891b43a4a4995e6b4e59c109e652dc99ea62d1f0ca0b5
|
|
| MD5 |
3e5caddb4dea6a83704f48967db6c47f
|
|
| BLAKE2b-256 |
95c06c938f9be5462919094dd2b443735bcd12fedbd972fe17c40028c6923fcf
|