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