StormAxis MCP Server

Give your AI agent real-time US storm intelligence. StormAxis connects Claude, GPT, and any MCP-compatible agent to live NOAA storm data, scored contractor opportunities, property targeting lists, and canvass route optimization — purpose-built for roofing and restoration contractors.

What it does

StormAxis watches every storm in the United States in real time. When a qualifying hail or wind event hits, it automatically scores it (0–100) based on severity, local property values, roof age, and historical claim rates — then surfaces the best opportunities to your agent.

Your AI agent can:

• Ask "What are the best storm opportunities in Texas right now?" and get a ranked list with estimated revenue
• Pull a property target list for any ZIP code hit by a scored storm
• Get H3-optimized canvass clusters so field crews know exactly where to knock doors first
• Check insurance claim propensity by state before committing resources to a new market
• Subscribe to webhooks that fire the moment a qualifying storm lands in your territory

Quickstart

1. Get a Partner API key

Sign up at stormaxis.io/partner. MCP access requires Growth tier ($199/mo) or above.

2. Add to Claude Code

claude mcp add stormaxis \
  --transport sse \
  --url https://stormaxis.io/api/mcp/sse \
  --header "X-API-Key: YOUR_API_KEY"

3. Make your first call

Ask Claude: "Check the StormAxis pipeline status."

You should see pipeline_active: true and a latest_event_time within the last 48 hours. You're live.

Alternative Setup Methods

Claude Desktop (via mcp-remote)

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "stormaxis": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://stormaxis.io/api/mcp/sse"],
      "env": {
        "MCP_REMOTE_HEADER_X_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Standalone npm server (stdio)

npm install -g stormaxis-mcp

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "stormaxis": {
      "command": "stormaxis-mcp",
      "env": {
        "STORMAXIS_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Local development

git clone https://github.com/stormaxis/stormaxis-mcp
cd stormaxis-mcp
cp .env.example .env          # add your API key
npm install
npm run build
npm start

Tool Reference

Full mapping of MCP tools to their underlying Partner API endpoints.

| MCP Tool | REST Endpoint | Tier | Key Parameters | Description | |---|---|---|---|---| | get_storm_overview | GET /api/v1/partner/storm/overview | Growth | — | US storm snapshot — counts by type, top states, SPC outlook | | get_top_opportunities | GET /api/v1/partner/opportunities/top | Growth | state? min_score? limit? | Last 30 days of storms ranked by opportunity score (0–100) | | get_storm_score | GET /api/v1/partner/storm/{id}/score | Growth | storm_id | Full composite score breakdown: storm relevance, property economics, replacement probability | | search_properties | GET /api/v1/partner/properties/{zip} | Professional | zip_code owner_type? min_roof_age? min_sqft? limit? | Owner + property records for door-knock targeting | | get_canvass_clusters | GET /api/v1/partner/clusters/{storm_id} | Professional | storm_id min_score? limit? | H3 hexagonal canvass zones ranked by doors/hour × owner-occupancy | | get_insurance_propensity | GET /api/v1/partner/analytics/insurance-propensity | Growth | state? | Claim culture score + avg payout per state | | get_fema_claims | GET /api/v1/partner/fema/claims | Professional | state year_start? year_end? | Historical NFIP flood claims aggregated by ZIP | | get_pipeline_status | GET /api/v1/partner/pipeline/status | Growth | — | Data freshness and ingestion health check |

Score Components (get_storm_score)

| Component | What it measures | |---|---| | storm_relevance_score | Recency, magnitude, NWS confirmation | | property_economics_score | Avg property value, roof age, density | | replacement_probability | ML prediction of claim conversion likelihood |

Prompts

The server ships two pre-built prompt templates that chain multiple tools into a single natural-language request:

| Prompt | Arguments | Description | |---|---|---| | storm_assessment | state (default: TX) | Full briefing: overview → top opportunities → score breakdown → property targeting | | property_search | zip_code (default: 76109) | Find older-roof properties in a ZIP with active storm context |

Example Agent Workflows

Daily Sales Briefing

1. get_storm_overview           → What's active nationally?
2. get_top_opportunities        → Which markets rank highest today?
3. get_insurance_propensity     → Which states convert claims best?
4. get_storm_score(top_id)      → Deep-dive on #1 opportunity

Field Operations Planning

1. get_top_opportunities(state="TX")   → Identify top TX storm
2. get_canvass_clusters(storm_id)      → Get optimized zones
3. search_properties(zip_code)         → Pull door-knock list per zone

New Market Assessment

1. get_insurance_propensity(state)               → How claim-friendly is this state?
2. get_fema_claims(state)                        → Historical flood risk by ZIP
3. get_top_opportunities(state, min_score=50)    → Any current opportunities?

Pricing

| Tier | Price | Daily API Calls | MCP Access | Tools Available | Webhooks | |---|---|---|---|---|---| | Sandbox | Free | 100 | No | Dashboard only | No | | Growth | $199/mo | 5,000 | Yes | get_storm_overview, get_top_opportunities, get_storm_score, get_insurance_propensity, get_pipeline_status | No | | Professional | $499/mo | 25,000 | Yes | All 8 tools | No | | Enterprise | $1,499+/mo | 100,000 | Yes | All tools + Bulk Export | Included |

Overage: $0.05–$0.08 per 1,000 calls on Growth and above.

Webhook Subscriptions (storm.scored, storm.gold, storm.updated, properties.available, pipeline.alert) are available on Enterprise tier and are included in the base price. See /docs/webhooks.md.

Error Reference

| Error | Cause | |---|---| | Missing X-API-Key header | No API key in request | | Invalid or inactive API key | Key not found or revoked | | API key expired | Key has passed expiration date | | MCP access requires Growth tier or above | Sandbox key — upgrade at stormaxis.io/partner | | Daily limit of N calls reached | Rate limit hit — resets midnight UTC | | Storm {id} not found | Invalid or expired storm ID | | Database unavailable | Transient backend error — retry with exponential backoff |

Data Sources

| Source | Data Type | Refresh Frequency | |---|---|---| | NOAA/NWS Storm Data | Verified storm events | Continuous | | SPC Convective Outlooks | Risk forecasts | Every 15 minutes | | MRMS (Multi-Radar Multi-Sensor) | Hail size validation | Every 6 hours | | US County Assessor Records | Property data | Monthly | | FEMA NFIP Claims | Flood insurance history | Annual |

Storm opportunity scores are recomputed every 6 hours as new events are confirmed.

Examples

• Roofing Contractor Agent — Identify storm hits in your territory and generate a lead list
• Insurance Risk Assessment Agent — Post-storm property risk assessment using parcel data and claim propensity
• Dispatch Automation Agent — Auto-dispatch crews when a qualifying storm is detected via webhook

Docs

• Authentication & API Keys
• Webhook Events

Support

• Partner Portal: stormaxis.io/partner
• Documentation: stormaxis.io/partner/docs
• Issues: tyler@stormaxis.io