Stormaxis Mcp

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: [email protected]