@driftwest/mcp-server 1.1.1

package/README.md

@@ -0,0 +1,157 @@
+# @driftwest/mcp-server
+
+[![npm version](https://img.shields.io/npm/v/@driftwest/mcp-server)](https://www.npmjs.com/package/@driftwest/mcp-server)
+[![MCP Server](https://img.shields.io/badge/MCP-Server-blue)](https://modelcontextprotocol.io)
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
+
+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`:
+
+```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`:
+
+```json
+{
+  "mcpServers": {
+    "driftwest": {
+      "command": "npx",
+      "args": ["@driftwest/mcp-server"],
+      "env": {
+        "DRIFTWEST_API_KEY": "dw_your_key_here"
+      }
+    }
+  }
+}
+```
+
+### Get an API Key (Free)
+
+```bash
+curl -X POST https://driftwest.xyz/api/account/register \
+  -H "Content-Type: application/json" \
+  -d '{"email":"you@example.com"}'
+```
+
+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):
+
+```bash
+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

package/examples/quickstart.md

@@ -0,0 +1,122 @@
+# DriftWest MCP Server — Quickstart Guide
+
+## 1. Install & Configure (2 minutes)
+
+### Get a Free API Key
+
+```bash
+curl -X POST https://driftwest.xyz/api/account/register \
+  -H "Content-Type: application/json" \
+  -d '{"email":"you@example.com"}'
+```
+
+Save the `apiKey` from the response. It starts with `dw_`.
+
+### Add to Claude Desktop
+
+Edit `~/.claude/claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "driftwest": {
+      "command": "npx",
+      "args": ["@driftwest/mcp-server"],
+      "env": {
+        "DRIFTWEST_API_KEY": "dw_your_key_here"
+      }
+    }
+  }
+}
+```
+
+Restart Claude Desktop. You'll see "driftwest" in the MCP tools panel.
+
+### Add to Claude Code (CLI)
+
+```bash
+claude mcp add driftwest -- npx @driftwest/mcp-server
+```
+
+Or add to `.mcp.json` in your project root.
+
+### Add to Cursor
+
+Settings > MCP > Add Server:
+- Name: `driftwest`
+- Command: `npx @driftwest/mcp-server`
+- Environment: `DRIFTWEST_API_KEY=dw_your_key`
+
+## 2. Try These Prompts
+
+Once connected, try asking your AI assistant:
+
+### Environmental Monitoring
+- "What are the current EMF readings from the Alberta sensors?"
+- "Show me space weather conditions — any solar storms?"
+- "What's the air quality in Calgary right now?"
+
+### Beach & Water Quality
+- "Find the top 5 beaches in BC by water quality"
+- "Compare water quality between Kits Beach and English Bay"
+- "Which beaches have algae bloom risk right now?"
+
+### Safety & Decision Support
+- "Is it safe to go hiking near Banff today? Check wildfire, air quality, and seismic."
+- "Give me a safety check for Vancouver — wildfire smoke, earthquakes, air quality"
+
+### Research Queries
+- "Show me EMF correlations with weather and lunar cycles"
+- "What's the seismic activity near the Cascadia zone?"
+- "How has air quality trended in Edmonton this week?"
+
+## 3. Example Workflows
+
+### Environmental Report Generator
+
+Ask Claude to build a daily environmental briefing:
+
+> "Using the DriftWest tools, create a daily environmental briefing for Alberta that includes:
+> 1. Current EMF sensor readings and any anomalies
+> 2. Air quality for Calgary, Edmonton, and Red Deer
+> 3. Any active wildfire hotspots
+> 4. Space weather conditions
+> 5. Recent seismic activity near Alberta
+> Format as a concise morning briefing."
+
+### Beach Trip Planner
+
+> "I want to plan a beach day this weekend in BC. Use the beach tools to:
+> 1. Find the top 3 beaches near Vancouver by recreation score
+> 2. Check water quality for each
+> 3. Check algae risk
+> 4. Run a safety check for the area
+> Give me a recommendation with a backup option."
+
+### Research Data Collection
+
+> "I'm studying EMF-weather correlations. Pull the latest correlation report
+> and the 24-hour EMF statistics. Summarize any patterns you see between
+> electromagnetic fields and environmental conditions."
+
+## 4. Upgrade to Researcher ($29/mo)
+
+The free tier gives you 60 requests/minute and 1 day of history. Upgrade for:
+- 300 req/min, 50K daily
+- 30-day historical data
+- Batch queries
+- Priority support
+
+```bash
+curl -X POST https://driftwest.xyz/api/account/checkout \
+  -H "Content-Type: application/json" \
+  -H "X-API-Key: dw_your_key"
+```
+
+Opens Stripe checkout. Tier upgrades instantly after payment.
+
+## 5. Need Help?
+
+- API Docs: https://driftwest.xyz/llms.txt
+- Issues: https://github.com/driftwest/mcp-server/issues
+- Email: info@nimpact.ca

package/examples/research-notebook.py

@@ -0,0 +1,159 @@
+#!/usr/bin/env python3
+"""
+DriftWest MCP Server — Research Data Examples
+==============================================
+Shows how to use the DriftWest API directly from Python
+for research data collection and analysis.
+
+API Base: https://driftwest.xyz/api
+Auth: X-API-Key header with your dw_ key
+
+These are the same endpoints the MCP server uses internally.
+Use these for building custom pipelines, dashboards, or datasets.
+"""
+
+import requests
+import json
+from datetime import datetime
+
+API_BASE = "https://driftwest.xyz/api"
+# Replace with your API key (register at /api/account/register)
+API_KEY = "dw_your_key_here"
+
+headers = {
+    "Content-Type": "application/json",
+    "X-API-Key": API_KEY
+}
+
+
+def example_emf_latest():
+    """Get the latest EMF sensor readings from all nodes."""
+    print("\n=== EMF Latest Readings ===")
+    res = requests.get(f"{API_BASE}/emf/latest", headers=headers)
+    data = res.json()
+    for node in data.get("nodes", []):
+        print(f"  {node['name']}: {node.get('emf', 'N/A')} uT | "
+              f"Temp: {node.get('temperature', 'N/A')}C | "
+              f"Status: {'online' if node.get('online') else 'offline'}")
+
+
+def example_beach_search():
+    """Search for beaches by location and quality."""
+    print("\n=== Top Beaches in BC ===")
+    res = requests.get(f"{API_BASE}/beaches/search", headers=headers, params={
+        "province": "BC",
+        "limit": 5,
+        "sort": "wqi"
+    })
+    data = res.json()
+    for i, beach in enumerate(data.get("beaches", []), 1):
+        print(f"  {i}. {beach['name']} — WQI: {beach.get('wqi', 'N/A')}, "
+              f"Biodiversity: {beach.get('biodiversity_score', 'N/A')}")
+
+
+def example_air_quality():
+    """Get current air quality for all monitored cities."""
+    print("\n=== Air Quality Rankings ===")
+    res = requests.get(f"{API_BASE}/air-quality/rankings", headers=headers)
+    data = res.json()
+    for city in data.get("cities", [])[:5]:
+        aqi = city.get("aqi", "N/A")
+        risk = city.get("health_risk", "N/A")
+        print(f"  {city['name']}: AQI {aqi} (Risk: {risk})")
+
+
+def example_safety_check():
+    """Run a composite safety check for a location."""
+    print("\n=== Safety Check: Calgary ===")
+    res = requests.get(f"{API_BASE}/safety/check", headers=headers, params={
+        "lat": 51.0447,
+        "lon": -114.0719
+    })
+    data = res.json()
+    print(f"  Verdict: {data.get('verdict', 'N/A')}")
+    print(f"  Air Quality: {data.get('air_quality', {}).get('status', 'N/A')}")
+    print(f"  Wildfire: {data.get('wildfire', {}).get('status', 'N/A')}")
+    print(f"  Seismic: {data.get('seismic', {}).get('status', 'N/A')}")
+
+
+def example_space_weather():
+    """Check current space weather conditions."""
+    print("\n=== Space Weather ===")
+    res = requests.get(f"{API_BASE}/space-weather/current", headers=headers)
+    data = res.json()
+    print(f"  Kp Index: {data.get('kp', 'N/A')}")
+    print(f"  Dst Index: {data.get('dst', 'N/A')} nT")
+    print(f"  Solar Wind: {data.get('solar_wind_speed', 'N/A')} km/s")
+    print(f"  Disturbance: {data.get('disturbance_score', 'N/A')}/10")
+
+
+def example_build_dataset():
+    """
+    Build a research dataset combining multiple data sources.
+    This demonstrates how to create cross-domain environmental datasets.
+    """
+    print("\n=== Building Cross-Domain Dataset ===")
+
+    dataset = {
+        "timestamp": datetime.now().isoformat(),
+        "emf": {},
+        "air_quality": {},
+        "space_weather": {},
+        "seismic": {}
+    }
+
+    # Collect EMF data
+    try:
+        res = requests.get(f"{API_BASE}/emf/stats", headers=headers)
+        dataset["emf"] = res.json()
+        print("  [x] EMF stats collected")
+    except Exception as e:
+        print(f"  [ ] EMF: {e}")
+
+    # Collect air quality
+    try:
+        res = requests.get(f"{API_BASE}/air-quality/current", headers=headers)
+        dataset["air_quality"] = res.json()
+        print("  [x] Air quality collected")
+    except Exception as e:
+        print(f"  [ ] Air quality: {e}")
+
+    # Collect space weather
+    try:
+        res = requests.get(f"{API_BASE}/space-weather/current", headers=headers)
+        dataset["space_weather"] = res.json()
+        print("  [x] Space weather collected")
+    except Exception as e:
+        print(f"  [ ] Space weather: {e}")
+
+    # Collect seismic
+    try:
+        res = requests.get(f"{API_BASE}/seismic/recent", headers=headers)
+        dataset["seismic"] = res.json()
+        print("  [x] Seismic data collected")
+    except Exception as e:
+        print(f"  [ ] Seismic: {e}")
+
+    # Save dataset
+    filename = f"driftwest_snapshot_{datetime.now().strftime('%Y%m%d_%H%M')}.json"
+    with open(filename, "w") as f:
+        json.dump(dataset, f, indent=2)
+    print(f"\n  Saved to {filename}")
+
+
+if __name__ == "__main__":
+    print("DriftWest Environmental Data — Research Examples")
+    print("=" * 50)
+    print(f"API: {API_BASE}")
+    print(f"Time: {datetime.now().strftime('%Y-%m-%d %H:%M:%S')}")
+
+    # Uncomment the examples you want to run:
+    # example_emf_latest()
+    # example_beach_search()
+    # example_air_quality()
+    # example_safety_check()
+    # example_space_weather()
+    # example_build_dataset()
+
+    print("\nUncomment the examples above to run them.")
+    print("Get your API key: curl -X POST https://driftwest.xyz/api/account/register -H 'Content-Type: application/json' -d '{\"email\":\"you@example.com\"}'")