Stormaxis Mcp

StormAxis MCP 服务

为你的 AI Agent 提供实时美国风暴情报。 StormAxis 将 Claude、GPT 和任何兼容 MCP 的 Agent 连接到 NOAA 实时风暴数据、评分后的承包商商机、目标房产列表和上门拜访路线优化工具，专为屋顶和灾后修复承包商打造。

---

功能

StormAxis 实时监控美国境内的每场风暴。达到条件的冰雹或大风事件发生时，系统会根据严重程度、当地房产价值、屋顶屋龄和历史理赔率自动评分（0–100），然后向你的 Agent 展示最佳商机。

你的 AI Agent 可以：

• 询问 “目前德克萨斯州有哪些最佳风暴商机？”，获取按优先级排序的列表和预估收入
• 获取受已评分风暴影响的任意邮政编码区域的目标房产列表
• 获取经过 H3 优化的上门拜访区域集群，让外勤团队准确掌握首先上门拜访的地点
• 在决定进入新市场之前，查询各州的保险理赔倾向
• 订阅 Webhook，在符合条件的风暴进入你的服务区域时立即触发

---

快速开始

1. 获取 Partner API 密钥

在 stormaxis.io/partner 注册。MCP 访问需要 Growth 等级（$199/月）或更高级别。

2. 添加到 Claude Code

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

3. 发起首次调用

Ask Claude: "Check the StormAxis pipeline status."

你应该会看到 pipeline_active: true，且 latest_event_time 的时间在过去 48 小时内。现在已成功连接。

---

其他设置方式

Claude Desktop（通过 mcp-remote）

添加到 ~/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"
      }
    }
  }
}

独立 npm 服务（stdio）

npm install -g stormaxis-mcp

添加到 claude_desktop_config.json：

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

本地开发

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

---

工具参考

MCP 工具与其对应 Partner API 端点的完整映射。

MCP 工具	REST 端点	等级	关键参数	说明
get_storm_overview	GET /api/v1/partner/storm/overview	Growth	—	美国风暴概览——按类型统计、排名靠前的州、SPC 展望
get_top_opportunities	GET /api/v1/partner/opportunities/top	Growth	state? min_score? limit?	过去 30 天的风暴，按商机评分（0–100）排序
get_storm_score	GET /api/v1/partner/storm/{id}/score	Growth	storm_id	综合评分详情：风暴相关性、房产经济状况、更换概率
search_properties	GET /api/v1/partner/properties/{zip}	Professional	zip_code owner_type? min_roof_age? min_sqft? limit?	用于上门拜访目标筛选的业主和房产记录
get_canvass_clusters	GET /api/v1/partner/clusters/{storm_id}	Professional	storm_id min_score? limit?	按每小时敲门数 × 业主自住率排序的 H3 六边形上门拜访区域
get_insurance_propensity	GET /api/v1/partner/analytics/insurance-propensity	Growth	state?	各州的理赔倾向评分和平均赔付金额
get_fema_claims	GET /api/v1/partner/fema/claims	Professional	state year_start? year_end?	按邮政编码汇总的 NFIP 历史洪水理赔数据
get_pipeline_status	GET /api/v1/partner/pipeline/status	Growth	—	数据新鲜度和数据摄取健康状况检查

评分组成部分（get_storm_score）

组成部分	衡量内容
storm_relevance_score	时效性、强度、NWS 确认情况
property_economics_score	平均房产价值、屋顶屋龄、密度
replacement_probability	对理赔转化可能性的机器学习预测

提示词

该服务内置了两个提示词模板，可将多个工具串联为一个自然语言请求：

提示词	参数	描述
storm_assessment	state（默认值：TX）	完整简报：概览 → 顶级机会 → 评分细目 → 房产定位
property_search	zip_code（默认值：76109）	查找有活跃风暴背景且屋顶较旧的 ZIP 区域房产

---

Agent 工作流示例

每日销售简报

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

现场运营规划

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

新市场评估

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?

---

定价

套餐	价格	每日 API 调用次数	MCP 访问权限	可用工具	Webhook
Sandbox	免费	100	否	仅限控制面板	否
Growth	$199/mo	5,000	是	get_storm_overview、get_top_opportunities、get_storm_score、get_insurance_propensity、get_pipeline_status	否
Professional	$499/mo	25,000	是	全部 8 个工具	否
Enterprise	$1,499+/mo	100,000	是	所有工具 + 批量导出	已包含

超额费用：Growth 及以上套餐每 1,000 次调用收费 $0.05–$0.08。

Webhook 订阅（storm.scored、storm.gold、storm.updated、properties.available、pipeline.alert）适用于 Enterprise 套餐，且已包含在基础价格中。请参阅 /docs/webhooks.md。

---

错误参考

错误	原因
Missing X-API-Key header	请求中没有 API 密钥
Invalid or inactive API key	未找到密钥或密钥已撤销
API key expired	密钥已过期
MCP access requires Growth tier or above	Sandbox 密钥——请在 stormaxis.io/partner 升级
Daily limit of N calls reached	已达到速率限制——UTC 午夜重置
Storm {id} not found	风暴 ID 无效或已过期
Database unavailable	后端临时错误——请采用指数退避策略重试

---

数据来源

来源	数据类型	刷新频率
NOAA/NWS 风暴数据	已验证的风暴事件	持续更新
SPC 对流展望	风险预报	每 15 分钟
MRMS（多雷达多传感器）	冰雹尺寸验证	每 6 小时
美国县级房产评估记录	房产数据	每月
FEMA NFIP 理赔记录	洪水保险历史	每年

随着新事件得到确认，风暴机会评分每 6 小时重新计算一次。

---

示例

• 屋顶承包商 Agent — 识别所在区域内受风暴影响的地点，并生成潜在客户名单
• 保险风险评估 Agent — 使用地块数据和理赔倾向评估风暴过后的房产风险
• 派遣自动化 Agent — 通过 webhook 检测到符合条件的风暴时自动派遣施工队

---

文档

• 身份验证与 API 密钥
• Webhook 事件

---

支持

• 合作伙伴门户：stormaxis.io/partner
• 文档：stormaxis.io/partner/docs
• 问题反馈：[email protected]