Stormaxis Mcp

StormAxis MCP Server

AI エージェントに米国の嵐に関するリアルタイム情報を提供します。 StormAxis は Claude、GPT、および MCP 互換のあらゆるエージェントを、最新の NOAA の嵐データ、スコアリング済みの請負業者向け案件、物件ターゲットリスト、訪問ルート最適化に接続します。屋根工事および災害復旧の請負業者向けに特化して構築されています。

---

できること

StormAxis は米国全土のすべての嵐をリアルタイムで監視します。条件を満たすひょうや強風のイベントが発生すると、深刻度、地域の物件価値、屋根の築年数、過去の保険請求率に基づいて自動的にスコア（0～100）を付け、最適な案件をエージェントに提示します。

AI エージェントは次のことができます。

• *「今、テキサス州で最も有望な嵐関連の案件は？」*と尋ね、推定収益付きのランキングを取得する
• スコアリング済みの嵐が発生した ZIP コードの物件ターゲットリストを取得する
• 現場の作業員がどこから訪問すべきか正確に把握できるよう、H3 最適化済みの訪問エリアを取得する
• 新しい市場へのリソース投入を決める前に、州ごとの保険請求傾向を確認する
• 条件を満たす嵐が担当エリアに到達した瞬間に発火する Webhook を登録する

---

クイックスタート

1. Partner API キーを取得する

stormaxis.io/partner で登録してください。MCP にアクセスするには、Growth tier（$199/mo）以上が必要です。

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 と、直近 48 時間以内の latest_event_time が表示されるはずです。これで利用できます。

---

その他のセットアップ方法

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?	1 時間あたりの訪問件数 × 居住者所有率で順位付けされた、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?	ZIP コードごとに集計された NFIP の過去の洪水保険請求
get_pipeline_status	GET /api/v1/partner/pipeline/status	Growth	—	データの鮮度と取り込み状況の健全性チェック

スコアの構成要素（get_storm_score）

構成要素	測定内容
storm_relevance_score	発生時期、規模、NWS による確認
property_economics_score	物件の平均価値、屋根の築年数、密度
replacement_probability	保険請求への転換可能性を予測する ML モデルの予測値

---

プロンプト

このサーバーには、複数のツールを連携させて単一の自然言語リクエストにまとめる、事前構築済みのプロンプトテンプレートが2つ用意されています。

プロンプト	引数	説明
storm_assessment	state（デフォルト：TX）	詳細な概要：概要 → 最適な機会 → スコアの内訳 → 物件のターゲティング
property_search	zip_code（デフォルト：76109）	嵐の状況が発生中の ZIP コードで、屋根が古い物件を検索します

---

エージェントのワークフロー例

毎日の営業ブリーフィング

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?

---

料金

プラン	料金	1日の 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 の午前0時にリセットされます
Storm {id} not found	嵐の ID が無効か、有効期限が切れています
Database unavailable	一時的なバックエンドエラーです — 指数バックオフを使用して再試行してください

---

データソース

ソース	データの種類	更新頻度
NOAA/NWS Storm Data	検証済みの嵐の発生情報	継続的
SPC Convective Outlooks	リスク予測	15分ごと
MRMS (Multi-Radar Multi-Sensor)	雹のサイズ検証	6時間ごと
US County Assessor Records	物件データ	毎月
FEMA NFIP Claims	洪水保険の履歴	毎年

嵐の機会スコアは、新たな発生情報が確認されるたびに6時間ごとに再計算されます。

---

例

• 屋根工事業者エージェント — 担当地域で嵐の被害を特定し、見込み客リストを作成します
• 保険リスク評価エージェント — 区画データと保険金請求の可能性に基づき、嵐の後に物件リスクを評価します
• 派遣自動化エージェント — 条件を満たす嵐が Webhook 経由で検出された際に、作業員を自動派遣します

---

ドキュメント

• 認証と API キー
• Webhook イベント

---

サポート

• パートナーポータル：stormaxis.io/partner
• ドキュメント：stormaxis.io/partner/docs
• 問い合わせ：[email protected]