earth-data-mcp
Provides tools for querying earthquake and volcanic activity data, enabling a Discord bot to answer natural hazard questions.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@earth-data-mcpfind recent earthquakes near Tokyo"
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.
earth-data-mcp
An MCP server that gives AI agents live Earth data: earthquakes, volcanoes, weather and warnings, air quality, sea state, natural events, disaster alerts, space weather, and atmospheric CO2.
All upstream sources are public and unauthenticated, so the server needs no API keys or configuration.
Tools
Tool | Purpose |
| USGS earthquakes by magnitude, time window, and location radius. |
| Full detail for one USGS event. |
| Current weekly volcanic activity report, filterable by volcano or country. |
| Current conditions and daily forecast for a place or coordinates. |
| Hourly thunderstorm/lightning risk. |
| Official warnings (US NWS, or MeteoAlarm for Europe). |
| AQI, pollutants, UV, and pollen (Europe). |
| Waves, swell, sea temperature, and currents offshore. |
| NASA EONET events: wildfires, storms, icebergs, dust, … |
| GDACS disaster alerts with humanitarian impact levels. |
| NOAA storm scales, Kp, flares, and aurora outlook. |
| Mauna Loa atmospheric CO2: latest month, yearly change, last 24 months. |
Related MCP server: quake-mcp
Usage
bun install
bun run start # stdio
bun run start:http # HTTP on $PORT (default 3000) at /mcpAdd it to Claude Code:
claude mcp add earth-data -- bun /absolute/path/to/earth-data-mcp/src/index.jsDeploying
The HTTP mode is stateless, so it runs on any serverless host. The repo is set up for Vercel:
bunx vercel deploy --prod # → https://<project>.vercel.app/mcpOther options: Cloudflare Workers or Deno Deploy (with their own entry point),
or Render / Fly.io running bun run start:http. Static hosts like GitHub Pages
won't work.
The deployed endpoint is public. That is fine here since it only proxies read-only public data.
Eval
eval/ checks whether an agent picks the right tool, passes sensible
arguments, and reports answers that match the live upstream data.
ANTHROPIC_API_KEY=... bun run eval
MODEL=claude-opus-4-8 EFFORT=high RUNS=3 bun run eval
MOCK=1 bun run eval # scripted agent, no API callsScoring is deterministic (no LLM judge), and ground truth is fetched at run time. The command exits non-zero on failure.
Data sources
Open-Meteo forecast, geocoding, air quality, and marine APIs (CC BY 4.0; free tier is non-commercial)
License
MIT
This server cannot be deployed
Maintenance
Related MCP Connectors
Geospatial MCP server for earthquake, tsunami, volcano, disaster, and FX data queries.
- earthOAuthcom.mireye
MCP server for Mireye Earth — federal-source-cited geospatial data for any MCP-aware agent.
- UnifAPIOAuthcom.unifapi
Hosted MCP server for live public-data APIs and Skills for AI agents.
Real-time planetary signal engine and Model Context Protocol (MCP) server for autonomous AI agents.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA powerful MCP server that connects AI assistants to authoritative natural hazard data sources, enabling monitoring of earthquakes, tsunamis, volcanoes, and solar events with configurable alerts and webhooks.1MIT
- AlicenseAqualityCmaintenanceMCP server wrapping the USGS Earthquake Hazards API, enabling AI assistants to search the global earthquake catalog, look up event details, count quakes, find 'Did You Feel It' reports, and read realtime feeds.5MIT
- AlicenseAqualityDmaintenanceAn MCP server that gives AI agents clean, token-efficient access to US civic & property data — geocoding, census tracts, Opportunity Zones, ACS demographics, and FEMA flood zones — sourced entirely from free federal open data.531 npm1MIT
- FlicenseAqualityDmaintenanceExposes 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.1-