storm-mcp
storm-mcp
MCP-сервер, предоставляющий доступ к API аналитики рынков прогнозов Storm для любого клиента Model Context Protocol.
Storm — это автономный ИИ-агент, управляющий Eyewall Markets, сервисом аналитики рынков прогнозов, охватывающим Polymarket, Kalshi, Manifold, Futuur, Betfair, ForecastEx и другие площадки. Этот пакет представляет собой легкий MCP-мост через stdio, который позволяет LLM-клиентам — Claude Desktop, Claude Code, Cursor, Zed и любому другому хосту с поддержкой MCP — считывать канонические события Storm, кросс-площадочные спреды, каталог площадок и входящие оповещения пользователя в виде нативных вызовов инструментов.
Он предназначен для аналитиков, трейдеров и разработчиков агентов, у которых уже есть подписка Storm и которые хотят, чтобы их LLM-рабочее пространство видело то же, что и Storm.
Требуется уровень Edge
API Storm доступен только подписчикам уровня Edge ($499/мес). Сгенерируйте свой
api_keyна странице https://eyewallmarkets.com/account. Более низкие уровни подписки не имеют доступа к API и будут получатьHTTP 403при каждом обращении к любому эндпоинту этого сервера.
API-ключи имеют формат stk_, за которым следуют 48 шестнадцатеричных символов (всего 52 символа), и привязаны к одной учетной записи. Относитесь к ним как к любым другим учетным данным.
Полная документация API находится по адресу https://eyewallmarkets.com/api/docs.
Related MCP server: pmxt-mcp
Быстрый старт — Claude Desktop
Отредактируйте файл конфигурации MCP для Claude Desktop и добавьте запись storm в раздел mcpServers:
{
"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. Семь инструментов storm_* должны появиться в списке инструментов в любом новом диалоге.
Быстрый старт — Claude Code
claude mcp add storm npx -- -y @eyewallmarkets/storm-mcpЗатем экспортируйте API-ключ в среду, в которой Claude Code запускает сервер (или установите его в профиле вашей оболочки):
export STORM_API_KEY=stk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxТочный вызов CLI может отличаться в зависимости от версии Claude Code; см. официальную документацию по адресу https://docs.claude.com/en/docs/claude-code/mcp для получения канонической формы (включая способы передачи переменных окружения непосредственно в строке mcp add).
После установки выполните /mcp внутри Claude Code, чтобы убедиться, что сервер storm подключен и семь инструментов зарегистрированы.
Быстрый старт — Cursor
Cursor считывает определения MCP-серверов из файла ~/.cursor/mcp.json. Добавьте ту же структуру, что используется для Claude Desktop:
{
"mcpServers": {
"storm": {
"command": "npx",
"args": ["-y", "@eyewallmarkets/storm-mcp"],
"env": {
"STORM_API_KEY": "stk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}
}
}
}Перезагрузите интеграцию MCP в Cursor (Settings → MCP → Refresh).
Быстрый старт — Zed
Zed настраивает MCP-серверы в разделе assistant.context_servers в файле ~/.config/zed/settings.json:
{
"assistant": {
"context_servers": {
"storm": {
"command": "npx",
"args": ["-y", "@eyewallmarkets/storm-mcp"],
"env": {
"STORM_API_KEY": "stk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}
}
}
}
}Перезапустите Zed или перезагрузите панель помощника.
Конфигурация
Вся конфигурация осуществляется через переменные окружения, считываемые при запуске сервера.
Переменная | Обязательно | По умолчанию | Описание |
| да | — | API-ключ уровня Edge, формат |
| нет |
| Переопределение корня API. Полезно для стейджинга или локального сервера разработки. |
| нет |
| Тайм-аут запроса в миллисекундах. |
| нет |
| Один из уровней: |
Справочник инструментов
Все семь инструментов доступны только для чтения и идемпотентны. Структура аргументов задокументирована ниже в формате, похожем на 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"] }
}Пример запроса: "Перечисли следующие 20 открытых политических событий на Storm."
storm_get_event
Получение одного события по слагу, включая все связанные исходы и цены по каждой площадке.
{
"slug": { "type": "string", "required": true, "example": "us-pres-2028" }
}Пример запроса: "Получи полную запись Storm для us-pres-2028 и скажи мне, у какого исхода самый широкий кросс-площадочный спред."
storm_list_spreads
Список недавних кросс-площадочных спредов, где чистая прибыль (после комиссий) превышает порог. Отсортировано по убыванию прибыли (edge DESC).
{
"min_edge_bps": { "type": "integer", "default": 100 },
"limit": { "type": "integer", "default": 50, "max": 200 },
"cursor": { "type": "string", "optional": true }
}Пример запроса: "Покажи мне топ-10 спредов Storm с прибылью не менее 250 б.п. прямо сейчас."
storm_get_market
Поиск одной записи площадки/рынка по (venue_slug, external_id).
{
"venue": { "type": "string", "required": true, "example": "polymarket" },
"external_id": { "type": "string", "required": true }
}Пример запроса: "Найди рынок Polymarket 0xabc... на Storm."
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 по текущий момент."
Примеры транскриптов
Поиск кластера спредов с высокой прибылью
Пользователь: Найди мне все спреды Storm по выборам 2028 года с прибылью выше 300 б.п. и назови топ-3.
Помощник: (вызывает
storm_list_spreadsсmin_edge_bps: 300, limit: 50, фильтрует ответ по префиксу слага события2028_us_presidential_, затем вызываетstorm_get_eventдля топ-3 для обогащения данных)Возвращает три самых широких открытых спреда по выборам 2028 года, пару площадок с каждой стороны и информацию о том, на какой площадке находится более выгодная цена.
Разбор входящих сообщений
Пользователь: Опроси мой входящий ящик Storm и суммируй неподтвержденные оповещения, затем подтверди все, что ты суммировал.
Помощник: (вызывает
storm_get_alerts_inboxбезsince, суммирует элементы по категориям, затем вызываетstorm_ack_alertsсup_to, установленным на самый большой увиденныйid)Возвращает категоризированное резюме неподтвержденных оповещений (пересечения спредов, изменения статуса площадок, события разрешения) и подтверждает продвижение курсора, чтобы последующие опросы возвращали только новые элементы.
Ограничения скорости и обработка ошибок
API Storm на стороне сервера ограничивает количество запросов до 10 запросов в секунду на API-ключ. Если вы превысите этот лимит, сервер вернет HTTP 429 с заголовком Retry-After: 1. Этот 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 testУкажите локальный сервер разработки Storm, переопределив базу API:
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 и создает данные, предоставляемые этим сервером, — является отдельной внутренней кодовой базой. Этот пакет является лишь клиентским MCP-мостом к публичному API Storm, доступному только для чтения.
Отказ от ответственности
Это программное обеспечение и данные, которые оно предоставляет, предназначены только для информационных целей. Ничто из того, что возвращает 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