storm-mcp
storm-mcp
Stormクロス会場予測市場インテリジェンスAPIを、あらゆるModel Context Protocolクライアントに公開するMCPサーバー。
Stormは、Eyewall Marketsを運営する自律型AIエージェントであり、Polymarket、Kalshi、Manifold、Futuur、Betfair、ForecastExなどにまたがるクロス会場予測市場インテリジェンスサービスです。このパッケージは、軽量なstdio MCPブリッジであり、Claude Desktop、Claude Code、Cursor、Zed、その他MCP対応ホストなどのLLMクライアントが、Stormの標準的なイベント、クロス会場スプレッド、会場カタログ、ユーザーごとのアラート受信トレイをネイティブのツール呼び出しとして読み取れるようにします。
これは、すでにStormのサブスクリプションを持っており、自身のLLMワークスペースでStormが見ている情報を確認したいアナリスト、トレーダー、エージェント開発者を対象としています。
Edgeティアが必要
Storm APIはEdgeティアのサブスクライバー(月額499ドル)に限定されています。
api_keyは https://eyewallmarkets.com/account で生成してください。下位ティアにはAPIアクセス権がなく、このサーバーが呼び出すすべてのエンドポイントからHTTP 403が返されます。
APIキーはstk_の後に48文字の16進数が続く形式(合計52文字)で、単一のアカウントにスコープされています。他のベアラー認証情報と同様に扱ってください。
完全なAPIリファレンスは https://eyewallmarkets.com/api/docs にあります。
Related MCP server: pmxt-mcp
クイックスタート — Claude Desktop
Claude DesktopのMCP設定ファイルを編集し、mcpServersの下にstormエントリを追加します:
{
"mcpServers": {
"storm": {
"command": "npx",
"args": ["-y", "@eyewallmarkets/storm-mcp"],
"env": {
"STORM_API_KEY": "stk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}
}
}
}macOSのパスは以下の通りです:
~/Library/Application Support/Claude/claude_desktop_config.jsonLinux:
~/.config/Claude/claude_desktop_config.json· Windows:%APPDATA%\Claude\claude_desktop_config.json
Claude Desktopを再起動します。新しい会話内のツールリストに7つのstorm_*ツールが表示されるはずです。
クイックスタート — Claude Code
claude mcp add storm npx -- -y @eyewallmarkets/storm-mcp次に、Claude Codeがサーバーを起動する環境にAPIキーをエクスポートします(またはシェルプロファイルに設定します):
export STORM_API_KEY=stk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx正確なCLI呼び出しはClaude Codeのバージョンによって異なる場合があります。公式ドキュメント(https://docs.claude.com/en/docs/claude-code/mcp)で標準的な形式(mcp add行自体で環境変数を渡す方法を含む)を確認してください。
インストール後、Claude Code内で/mcpを実行し、stormサーバーが接続され、7つのツールが登録されていることを確認します。
クイックスタート — Cursor
Cursorは~/.cursor/mcp.jsonからMCPサーバー定義を読み取ります。Claude Desktopで使用したものと同じ形式を追加します:
{
"mcpServers": {
"storm": {
"command": "npx",
"args": ["-y", "@eyewallmarkets/storm-mcp"],
"env": {
"STORM_API_KEY": "stk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}
}
}
}CursorのMCP統合をリロードします(設定 → MCP → 更新)。
クイックスタート — Zed
Zedは~/.config/zed/settings.jsonのassistant.context_serversでMCPサーバーを設定します:
{
"assistant": {
"context_servers": {
"storm": {
"command": "npx",
"args": ["-y", "@eyewallmarkets/storm-mcp"],
"env": {
"STORM_API_KEY": "stk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}
}
}
}
}Zedを再起動するか、アシスタントパネルをリロードします。
設定
すべての設定は、サーバー起動時に読み込まれる環境変数によって行われます。
変数 | 必須 | デフォルト | 説明 |
| はい | — | EdgeティアのAPIキー。形式は |
| いいえ |
| APIルートを上書きします。ステージングやローカル開発サーバーに便利です。 |
| いいえ |
| リクエストごとのタイムアウト(ミリ秒)。 |
| いいえ |
|
|
ツールリファレンス
7つのツールはすべて読み取り専用で、べき等です。引数の形式は以下のJSONスキーマ風の形式で文書化されています。ライブスキーマはMCPクライアントが実際に認識するものです。
storm_list_events
標準的な(クロス会場の)イベントを一覧表示します。カーソルによるページネーションが可能です。
{
"limit": { "type": "integer", "default": 50, "max": 200 },
"cursor": { "type": "string", "optional": true },
"category": { "type": "string", "optional": true, "example": "politics" },
"status": { "type": "string", "optional": true, "enum": ["open", "closed", "resolved"] }
}プロンプト例: "Stormで次に公開される政治イベントを20件リストアップして。"
storm_get_event
スラグで単一のイベントを取得します。これには、リンクされたすべての結果と会場ごとの価格が含まれます。
{
"slug": { "type": "string", "required": true, "example": "us-pres-2028" }
}プロンプト例: "us-pres-2028のStormの全記録を取得して、どの結果が最も広いクロス会場スプレッドを持っているか教えて。"
storm_list_spreads
ネットエッジ(手数料差し引き後)が基準をクリアする最近のクロス会場スプレッドを一覧表示します。エッジの降順でソートされます。
{
"min_edge_bps": { "type": "integer", "default": 100 },
"limit": { "type": "integer", "default": 50, "max": 200 },
"cursor": { "type": "string", "optional": true }
}プロンプト例: "現在、少なくとも250 bpsのエッジがあるStormスプレッドのトップ10を表示して。"
storm_get_market
(venue_slug, external_id)で単一の会場/市場記録を検索します。
{
"venue": { "type": "string", "required": true, "example": "polymarket" },
"external_id": { "type": "string", "required": true }
}プロンプト例: "StormでPolymarket市場0xabc...を検索して。"
storm_list_venues
Stormが追跡するすべての会場を一覧表示します。規制状況(CFTC登録DCM、オフショアなど)、手数料体系、機能フラグ(オーダーブック、AMM、パリミュチュエル)が含まれます。
{}プロンプト例: "Stormが追跡している会場のうち、CFTC登録DCMはどれ?"
storm_get_alerts_inbox
ユーザーのAPIチャネルアラート受信トレイをポーリングします。Edgeサブスクライバーはアラートをapi配信チャネルにルーティングできます。このツールは未確認のキューを排出します。
{
"since": { "type": "integer", "minimum": 0, "optional": true, "example": 4521 }
}カーソルは、最後に確認したアラートの整数idです。新しいアラートのみを取得するには、前回のレスポンスからnext_sinceを渡します。省略すると、ユーザーの永続的な確認済みカーソルから読み取ります。プロンプト例: "Stormの受信トレイをポーリングして、まだ確認していないものをすべて要約して。"
storm_ack_alerts
永続的な確認済みカーソルを進め、今後の受信トレイポーリングで処理済みのアラートをスキップするようにします。カーソルはサーバー側にあり、MCPセッションをまたいで保持されます。
{
"up_to": { "type": "integer", "minimum": 0, "required": true, "example": 4530 }
}プロンプト例: "今までのStormアラートをすべて確認済みにして。"
トランスクリプト例
高エッジスプレッドクラスターの検索
ユーザー: エッジが300 bpsを超える2028年選挙のStormスプレッドをすべて見つけて、トップ3を教えて。
アシスタント: (
storm_list_spreadsをmin_edge_bps: 300, limit: 50で呼び出し、イベントスラグのプレフィックス2028_us_presidential_でレスポンスをフィルタリングし、トップ3に対してstorm_get_eventを呼び出して詳細を取得)現在オープンしている2028年選挙の最も広いスプレッド3つ、それぞれの両側の会場ペア、およびどの会場が安いレッグにあるかを返します。
受信トレイのトリアージ
ユーザー: Stormの受信トレイをポーリングして未確認のアラートを要約し、要約したものをすべて確認済みにして。
アシスタント: (
storm_get_alerts_inboxをsinceなしで呼び出し、カテゴリ別にアイテムを要約し、storm_ack_alertsをup_toに確認した最大のidを設定して呼び出す)未確認のアラート(スプレッドエッジのクロス、会場ステータスの変更、解決イベント)のカテゴリ別要約を返し、カーソルが進んだことを確認して、その後のポーリングで新しいアイテムのみが返されるようにします。
レート制限とエラー処理
Storm APIは、サーバー側でAPIキーごとに毎秒10リクエストを強制しています。これを超えると、サーバーはRetry-After: 1と共にHTTP 429を返します。このMCPブリッジは自動的に再試行しません。エラーをツール結果のプレーンテキストコンテンツとしてLLMに表示し、モデルがバックオフ、再試行、または諦めるかを判断できるようにします。
エラーは以下の形式でLLMに返されます(ツール結果のテキストコンテンツ、isError: true):
Storm API error (HTTP 429, rate_limited): too many requests Retry after 1000 ms.Storm API error (HTTP 403, edge_tier_required): edge_tier_requiredStorm API error (HTTP 401, invalid_credentials): invalid_credentialsネットワークレベルの障害(DNS、TCP、TLS、タイムアウト)は以下のように表示されます:
Storm API error (HTTP 0, transport): request timeout完全なHTTPステータス、Stormエラーコード、および人間が読めるメッセージが常に含まれているため、LLMはそれに基づいて行動できます。
開発
git clone https://github.com/lsudduth/storm-mcp.git
cd storm-mcp
npm install
npm testAPIベースを上書きして、ローカルのStorm開発サーバーを指定します:
STORM_API_BASE=http://localhost:8080/api/v1 \
STORM_API_KEY=stk_dev_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx \
node src/index.mjsサーバーはstdio MCPで通信するため、任意のMCPテストハーネスを使用するか、JSON-RPCフレームを手動でパイプすることで直接操作できます。
テストにはNodeの組み込みテストランナーを使用しています。Jest、Vitest、トランスパイラは使用していません。
ライセンス
MIT — LICENSEを参照してください。
© 2026 XCH1TB, LLC dba Eyewall Markets.
Storm自体(Eyewall Marketsを運営し、このサーバーが公開するデータを生成する自律型AIエージェント)は、別の内部コードベースです。このパッケージは、Stormの公開読み取り専用APIサーフェスへのクライアント向けMCPブリッジに過ぎません。
免責事項
本ソフトウェアおよびそれが公開するデータは、情報提供のみを目的として提供されています。StormまたはこのMCPサーバーによって返されるいかなる情報も、法的、財務的、税務的、または投資に関するアドバイスではありません。予測市場への参加は、現地の法律および会場独自の適格性規則に従う必要があります。特に、Polymarketは米国ではCFTC命令により制限されており、ほとんどの米国居住者は利用できません。会場の適格性はStormやこのサーバーではなく、ユーザー自身の責任です。 Stormは公開されている市場状態を集約するものであり、ユーザーに代わって取引を行うことはありません。
Available Tools
7 toolsstorm_ack_alertsA
Advance the persistent ack cursor to the given sequence id, removing items at or below it from the api-channel inbox. Call this after the LLM / agent has processed items returned by storm_get_alerts_inbox; otherwise the same items will keep being returned. Sourced from Eyewall Markets / Storm. The cursor is server-side and survives across MCP sessions.
Inputs: up_to (required).
storm_get_alerts_inboxA
Poll the subscriber's api-channel notification inbox for cross-venue price-difference and event notifications that haven't been ack'd yet. Each item is a descriptive notification — it names the canonical event, the two venues, the prices each venue was publishing at the observation timestamp, and the rule that matched. Sourced from Eyewall Markets / Storm. Pass the next_since returned by the previous call as since to get only newer items. After processing, call storm_ack_alerts to advance the persistent cursor.
Inputs: since.
storm_get_eventA
Fetch a single canonical event by its Storm slug, including the full set of cross-venue markets attached to that event and each venue's currently published price. Use after storm_list_events when you need the canonical question text, resolution criteria, and per-venue market handles. Sourced from Eyewall Markets / Storm; describes the published-price observation, not a buy or sell recommendation.
Inputs: slug (required).
storm_get_marketA
Fetch the canonical Storm view of a single market on a specific venue, including the venue's currently published bid/ask, volume, and the canonical event it's joined to. Use when you have a venue + the venue's native market id (e.g. a Kalshi ticker or Polymarket condition id) and want Storm's normalized representation. Sourced from Eyewall Markets / Storm; describes published price snapshots from the venue's public read endpoints, not a recommendation.
Inputs: venue (required), external_id (required).
storm_list_eventsA
List canonical prediction-market events (questions/topics) tracked by Eyewall Markets / Storm across the public venues it covers (Kalshi, Polymarket, Manifold, ForecastEx, and others). Use this to discover what events exist before drilling into a specific event with storm_get_event. Supports filtering by category (e.g. 'politics', 'economics') and status (e.g. 'open', 'resolved'), and is cursor-paginated. Read-only market reference data; describes the event ontology, not a recommendation.
Inputs: limit, cursor, category, status.
storm_list_spreadsA
List recent cross-venue published-price observations — pairs of markets on different venues that are publishing different prices for the same canonical outcome. Returns rows whose published-price difference net of each venue's posted fees clears the configured floor, ordered by net_edge_bps DESC. Sourced from Eyewall Markets / Storm. Descriptive market-data only: each row reports what each venue is publishing, not a buy or sell recommendation, and does not warrant fillable depth at any price reported.
Inputs: min_edge_bps, limit, cursor.
storm_list_venuesA
List all public prediction-market venues covered by Eyewall Markets / Storm, with their slugs, display names, regulatory posture (CFTC-registered DCM, offshore, etc.), posted fee schedules, capability flags (orderbook / AMM / parimutuel), and current ingestion status. Call this first when you need the venue slug to pass to storm_get_market. Reference data only — venue eligibility for any individual user is governed by the venue and the user's local law.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
Each tool targets a distinct action or resource: acking alerts, polling inbox, fetching events/markets, listing events/spreads/venues. No two tools have overlapping purposes, and descriptions clearly differentiate them.
All tools follow a consistent 'storm_verb_noun' pattern in snake_case, with verbs like ack, get, list. This makes it easy for an agent to infer functionality from names.
7 tools is a well-scoped set for a prediction market data server. Each tool serves a necessary function without unnecessary duplication or gaps, covering discovery, detailed queries, and notification management.
The tool set covers the full lifecycle: discovering events (list), drilling into details (get), accessing markets (get), monitoring spreads and alerts, acknowledging alerts, and listing venues. No obvious missing operations for the stated purpose.
Maintenance
Related MCP Connectors
Historical tick, order book and settlement data for Polymarket and Predict.fun crypto up/down markets, plus smart-money lists and backtest quotes, over a read-only MCP server.
Hosted MCP for Kalshi prediction markets: search, odds, order books, settlement rules, and trading.
Hosted MCP server for live public-data APIs and Skills for AI agents.
MCP server exposing the Backtest360 engine API as tools for AI agents.
Related MCP Servers
- AlicenseBqualityDmaintenanceMCP-compatible server that gives AI agents access to alternative sports data across 30+ leagues — odds, events, probabilities, settlement, and futures for prediction markets, DFS platforms, and sportsbooks.2918 PyPIMIT
- AlicenseCqualityDmaintenanceMCP server that provides a unified prediction market API for multiple venues like Polymarket and Kalshi, allowing AI agents to discover markets, fetch order books, and execute trades through a single interface.328MIT
- FlicenseNot gradedqualityDmaintenanceMCP server that exposes Polymarket prediction markets via CLI wrapper. Enables AI agents to discover markets, check prices, and place trades programmatically.-
- AlicenseNot gradedqualityCmaintenanceMCP server for querying and optionally trading across prediction markets (Polymarket, Kalshi, Limitless, Manifold) through a unified API.31MIT