@driftwest/mcp-server

Model Context Protocol server for DriftWest environmental data. Gives AI agents (Claude Desktop, Cursor, Windsurf, etc.) direct access to 28 tools across 6 environmental domains.

Quick Setup

Claude Desktop

Add to ~/.claude/claude_desktop_config.json:

{
  "mcpServers": {
    "driftwest": {
      "command": "npx",
      "args": ["@driftwest/mcp-server"],
      "env": {
        "DRIFTWEST_API_KEY": "dw_your_key_here"
      }
    }
  }
}

Claude Code (CLI)

Add to .mcp.json in your project or ~/.claude.json:

{
  "mcpServers": {
    "driftwest": {
      "command": "npx",
      "args": ["@driftwest/mcp-server"],
      "env": {
        "DRIFTWEST_API_KEY": "dw_your_key_here"
      }
    }
  }
}

Get an API Key (Free)

curl -X POST https://driftwest.xyz/api/account/register \
  -H "Content-Type: application/json" \
  -d '{"email":"[email protected]"}'

Save the apiKey from the response — it cannot be retrieved later.

API Tiers

| Tier | Rate Limit | Daily Limit | History | Batch | Price | |------|-----------|-------------|---------|-------|-------| | Anonymous | 30/min | 1,000 | 1 day | No | Free | | Free | 60/min | 5,000 | 1 day | No | Free (register) | | Researcher | 300/min | 50,000 | 30 days | Yes | $29/mo CAD | | Enterprise | 1,000/min | 500,000 | 365 days | Yes | Contact us |

Upgrade to Researcher ($29/mo CAD):

curl -X POST https://driftwest.xyz/api/account/checkout \
  -H "Content-Type: application/json" \
  -H "X-API-Key: dw_your_key" \
  | jq .checkoutUrl

Opens a Stripe checkout page. Your tier upgrades automatically after payment.

Available Tools (28)

EMF & Space Weather

| Tool | Description | |------|-------------| | emf_latest | Latest reading from any sensor node | | emf_stats | 24-hour statistics for all nodes | | emf_history | Historical time-series data | | sensor_nodes | List all nodes with online/offline status | | space_weather | Current Kp/Dst, solar wind, disturbance score | | space_weather_alerts | Active NOAA space weather alerts |

Coastal Environment (355 beaches)

| Tool | Description | |------|-------------| | search_beaches | Geographic beach search with all indices | | beach_detail | Complete beach dossier | | water_quality_rankings | Beaches ranked by WQI | | biodiversity_hotspots | Beaches ranked by biodiversity | | nearby_beaches | Find nearby beaches by location | | shoreline_risk_alerts | Beaches by environmental risk level | | compare_beaches | Side-by-side comparison of up to 10 beaches | | water_quality_summary | Provincial water quality statistics | | algae_risk | Algae bloom risk analysis |

Wildfire Monitoring

| Tool | Description | |------|-------------| | wildfire_current | Active fires, danger level, city proximity scores | | wildfire_hotspots | Fire hotspot locations from NASA FIRMS | | wildfire_smoke_impact | Per-city smoke impact with AQI and PM2.5 |

Air Quality (12 cities)

| Tool | Description | |------|-------------| | air_quality_current | All cities with AQI and health risk scores | | air_quality_city | Detailed pollutant breakdown for one city | | air_quality_rankings | Cities ranked by health risk score | | air_quality_alerts | Cities exceeding AQI 100 |

Seismic Activity

| Tool | Description | |------|-------------| | seismic_recent | Recent global earthquakes (M2.5+) from USGS | | seismic_canada | Canadian earthquakes only (M1.0+) | | seismic_activity_score | Risk zone scores for 5 Canadian zones | | seismic_nearby | Earthquakes near a geographic point |

Cross-Domain

| Tool | Description | |------|-------------| | alberta_environment | EMF + water quality + space weather dashboard |

Agent Decision Support

| Tool | Description | |------|-------------| | safety_check | Composite go/no-go verdict combining air quality, wildfire proximity, and seismic activity for a location |

Resources

• driftwest://sensors/overview — All sensor nodes and 24h stats
• driftwest://datasets/catalog — Full dataset catalog description

Data Sources

• EMF Sensors: 3 ESP32 EMF nodes + 1 house monitor + 2 GOES satellite feeds in Alberta (sub-minute resolution)
• Space Weather: NOAA GOES satellites, Kp/Dst indices
• Coastal: 355 beaches across BC, Alberta, Oregon (Sentinel-2, Landsat 8/9)
• Wildfire: NASA FIRMS satellite fire detection (15-min refresh)
• Air Quality: Open-Meteo for 12 cities, 6 pollutants (15-min refresh)
• Seismic: USGS earthquake data, 5 Canadian risk zones (5-min refresh)

Links

• API Docs: https://driftwest.xyz/llms.txt
• OpenAPI Spec: https://driftwest.xyz/.well-known/openapi.json
• Homepage: https://driftwest.xyz

License

MIT