Skip to main content

MCP Server for real-time earthquake data and seismic monitoring via USGS Earthquake Catalog API

Project description

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

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

earthquake_mcp_server-0.1.0.tar.gz (7.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

earthquake_mcp_server-0.1.0-py3-none-any.whl (9.3 kB view details)

Uploaded Python 3

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

Hashes for earthquake_mcp_server-0.1.0.tar.gz
Algorithm Hash digest
SHA256 c7fa1aa9a811de73d2098ccab60217908d00c46ad397475a20882f57d2282780
MD5 f5f79a21fc1b92530a7a4d3a3a96fc25
BLAKE2b-256 095453dc724ebda8542669772d954f3ceb4c7413c80cb05318f15917b7a65577

See more details on using hashes here.

File details

Details for the file earthquake_mcp_server-0.1.0-py3-none-any.whl.

File metadata

File hashes

Hashes for earthquake_mcp_server-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 94fb070717172e4bed2891b43a4a4995e6b4e59c109e652dc99ea62d1f0ca0b5
MD5 3e5caddb4dea6a83704f48967db6c47f
BLAKE2b-256 95c06c938f9be5462919094dd2b443735bcd12fedbd972fe17c40028c6923fcf

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page