🌍 WEMS - World Event Monitoring System

🚨 Real-time Natural Hazard Monitoring for AI Agents

A powerful Model Context Protocol (MCP) server that connects AI assistants to authoritative natural hazard data sources. Monitor earthquakes, tsunamis, volcanoes, and solar events with configurable alerts and webhooks.

🤖 AI Agents: Skip scanning this repo. Read AI.TOC first — it's a 500-token project map. Then use AI.INDEX to find specific functions and AI.REGISTER for env vars, APIs, and config. This project uses the LBF AI Navigation Standard.

⚡ Key Features

• 🌋 9+ Authoritative Data Sources: USGS, NOAA, Smithsonian GVP, NHC, NIFC, OpenAQ, DHS, State Dept, CISA, US Drought Monitor
• 🎯 Real-time Monitoring: Live data feeds with customizable thresholds
• 🔔 Smart Alerts: Webhook notifications for critical events
• 🗺️ Geographic Filtering: Target specific regions or global coverage
• 🔧 Zero Configuration: Works out-of-the-box, configure only what you need
• 🐳 Production Ready: Docker support, comprehensive error handling

Natural Hazards Covered

🚀 Quick Start

Install via PyPI (Recommended)

pip install wems-mcp-server

Or install from source

git clone https://github.com/heliosarchitect/wems-mcp-server.git
cd wems-mcp-server
pip install -r requirements.txt

Basic Usage

# Run as MCP server (connects to AI assistants)
python -m wems_mcp_server

# Test earthquake monitoring
python -c "
import asyncio
from wems_mcp_server import check_earthquakes
print(asyncio.run(check_earthquakes(min_magnitude=6.0)))
"

One-command AI Alerting Setup (Relay + n8n)

bash scripts/setup_wems_alerting_ai.sh

This will:

• install/start wems-unified-relay.service
• upsert and activate the unified n8n ingest workflow
• wire tracker posting credentials automatically

Example Output

{
  "earthquakes_found": 3,
  "events": [
    {
      "magnitude": 7.2,
      "location": "67 km SW of Tres Picos, Mexico",
      "time": "2024-02-13T14:30:15Z",
      "depth": 35.8,
      "tsunami_threat": true
    }
  ]
}

MCP Tools

... View full README on GitHub