storm-mcp
storm-mcp
Servidor MCP que expone la API de inteligencia de mercados de predicción entre plataformas de Storm a cualquier cliente del Protocolo de Contexto de Modelo (MCP).
Storm es el agente de IA autónomo que opera Eyewall Markets, un servicio de inteligencia de mercados de predicción entre plataformas que abarca Polymarket, Kalshi, Manifold, Futuur, Betfair, ForecastEx y más. Este paquete es un puente MCP ligero de stdio que permite a los clientes LLM — Claude Desktop, Claude Code, Cursor, Zed y cualquier otro host compatible con MCP — leer los eventos canónicos, spreads entre plataformas, catálogo de plataformas y la bandeja de entrada de alertas por usuario de Storm como llamadas a herramientas nativas.
Está destinado a analistas, traders y desarrolladores de agentes que ya tienen una suscripción a Storm y desean que su espacio de trabajo LLM vea lo que Storm ve.
Se requiere el nivel Edge
La API de Storm está limitada a los suscriptores del nivel Edge ($499/mes). Genera tu
api_keyen https://eyewallmarkets.com/account. Los niveles inferiores no tienen acceso a la API y recibirán unHTTP 403de cada endpoint que llame este servidor.
Las claves API tienen el formato stk_ seguido de 48 caracteres hexadecimales (52 caracteres en total) y están vinculadas a una sola cuenta. Trátalas como cualquier otra credencial de portador.
La referencia completa de la API se encuentra en https://eyewallmarkets.com/api/docs.
Related MCP server: pmxt-mcp
Inicio rápido — Claude Desktop
Edita tu archivo de configuración MCP de Claude Desktop y añade una entrada storm bajo mcpServers:
{
"mcpServers": {
"storm": {
"command": "npx",
"args": ["-y", "@eyewallmarkets/storm-mcp"],
"env": {
"STORM_API_KEY": "stk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}
}
}
}La ruta en macOS es:
~/Library/Application Support/Claude/claude_desktop_config.jsonLinux:
~/.config/Claude/claude_desktop_config.json· Windows:%APPDATA%\Claude\claude_desktop_config.json.
Reinicia Claude Desktop. Las siete herramientas storm_* deberían aparecer en la lista de herramientas dentro de cualquier conversación nueva.
Inicio rápido — Claude Code
claude mcp add storm npx -- -y @eyewallmarkets/storm-mcpLuego exporta la clave API al entorno en el que Claude Code inicia el servidor (o establécela en tu perfil de shell):
export STORM_API_KEY=stk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxLa invocación exacta de la CLI puede variar según la versión de Claude Code; consulta la documentación oficial en https://docs.claude.com/en/docs/claude-code/mcp para conocer la forma canónica (incluyendo cómo pasar variables de entorno en la propia línea mcp add).
Después de la instalación, ejecuta /mcp dentro de Claude Code para confirmar que el servidor storm está conectado y que las siete herramientas están registradas.
Inicio rápido — Cursor
Cursor lee las definiciones del servidor MCP desde ~/.cursor/mcp.json. Añade la misma estructura utilizada para Claude Desktop:
{
"mcpServers": {
"storm": {
"command": "npx",
"args": ["-y", "@eyewallmarkets/storm-mcp"],
"env": {
"STORM_API_KEY": "stk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}
}
}
}Recarga la integración MCP de Cursor (Settings → MCP → Refresh).
Inicio rápido — Zed
Zed configura los servidores MCP bajo assistant.context_servers en ~/.config/zed/settings.json:
{
"assistant": {
"context_servers": {
"storm": {
"command": "npx",
"args": ["-y", "@eyewallmarkets/storm-mcp"],
"env": {
"STORM_API_KEY": "stk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}
}
}
}
}Reinicia Zed o recarga el panel del asistente.
Configuración
Toda la configuración se realiza mediante variables de entorno leídas al iniciar el servidor.
Variable | Requerido | Predeterminado | Descripción |
| sí | — | Clave API de nivel Edge, formato |
| no |
| Sobrescribe la raíz de la API. Útil para staging o un servidor de desarrollo local. |
| no |
| Tiempo de espera por solicitud en milisegundos. |
| no |
| Uno de |
Referencia de herramientas
Las siete herramientas son de solo lectura e idempotentes. Las estructuras de los argumentos se documentan a continuación en una forma similar a JSON-schema; el esquema en vivo es lo que el cliente MCP realmente ve.
storm_list_events
Enumera eventos canónicos (entre plataformas). Paginado por cursor.
{
"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"] }
}Ejemplo de prompt: "Enumera los próximos 20 eventos políticos abiertos en Storm."
storm_get_event
Obtén un solo evento por slug, incluyendo todos los resultados vinculados y los precios por plataforma.
{
"slug": { "type": "string", "required": true, "example": "us-pres-2028" }
}Ejemplo de prompt: "Obtén el registro completo de Storm para us-pres-2028 y dime qué resultado tiene el spread más amplio entre plataformas."
storm_list_spreads
Enumera los spreads recientes entre plataformas donde la ventaja neta (después de comisiones) supera el mínimo. Ordenado por ventaja DESC.
{
"min_edge_bps": { "type": "integer", "default": 100 },
"limit": { "type": "integer", "default": 50, "max": 200 },
"cursor": { "type": "string", "optional": true }
}Ejemplo de prompt: "Muéstrame los 10 mejores spreads de Storm con al menos 250 bps de ventaja ahora mismo."
storm_get_market
Busca un registro de plataforma/mercado único por (venue_slug, external_id).
{
"venue": { "type": "string", "required": true, "example": "polymarket" },
"external_id": { "type": "string", "required": true }
}Ejemplo de prompt: "Busca el mercado de Polymarket 0xabc... en Storm."
storm_list_venues
Enumera todas las plataformas que rastrea Storm, con estado regulatorio (DCM registrado por la CFTC, offshore, etc.), esquemas de comisiones y banderas de capacidad (libro de órdenes, AMM, parimutuel).
{}Ejemplo de prompt: "¿Qué plataformas que rastrea Storm son DCM registrados por la CFTC?"
storm_get_alerts_inbox
Consulta la bandeja de entrada de alertas del canal de API del usuario. Los suscriptores de Edge pueden dirigir alertas al canal de entrega api; esta herramienta vacía la cola no confirmada.
{
"since": { "type": "integer", "minimum": 0, "optional": true, "example": 4521 }
}El cursor es el id entero de la última alerta que has visto. Pasa next_since de la respuesta anterior para obtener solo alertas más nuevas; omítelo para leer desde el cursor de confirmación persistente del usuario. Ejemplo de prompt: "Consulta mi bandeja de entrada de Storm y resume todo lo que no he confirmado."
storm_ack_alerts
Avanza el cursor de confirmación persistente para que las futuras consultas de la bandeja de entrada omitan las alertas ya manejadas. El cursor está en el lado del servidor y sobrevive a través de las sesiones MCP.
{
"up_to": { "type": "integer", "minimum": 0, "required": true, "example": 4530 }
}Ejemplo de prompt: "Confirma todas las alertas de Storm hasta ahora."
Ejemplos de transcripciones
Encontrar un clúster de spreads de alta ventaja
Usuario: Encuéntrame todos los spreads de Storm para las elecciones de 2028 con una ventaja superior a 300 bps y dime los 3 mejores.
Asistente: (llama a
storm_list_spreadsconmin_edge_bps: 300, limit: 50, filtra la respuesta por el prefijo de slug de evento2028_us_presidential_, luego llama astorm_get_eventen los tres mejores para enriquecer)Devuelve los tres spreads de las elecciones de 2028 más amplios actualmente abiertos, el par de plataformas en cada lado y qué plataforma tiene la opción barata.
Triaje de bandeja de entrada
Usuario: Consulta mi bandeja de entrada de Storm y resume las alertas no confirmadas, luego confirma todo lo que resumiste.
Asistente: (llama a
storm_get_alerts_inboxsinsince, resume los elementos por categoría, luego llama astorm_ack_alertsconup_toestablecido en elidmás grande que vio)Devuelve un resumen categorizado de alertas no confirmadas (cruces de spread-edge, cambios de estado de plataforma, eventos de resolución) y confirma el avance del cursor para que las consultas posteriores solo devuelvan elementos nuevos.
Límites de tasa y manejo de errores
La API de Storm impone 10 solicitudes por segundo por clave API en el lado del servidor. Si excedes eso, el servidor devuelve HTTP 429 con Retry-After: 1. Este puente MCP no reintenta automáticamente; muestra el error al LLM como contenido de texto plano en el resultado de la herramienta para que el modelo pueda decidir si retroceder, reintentar o rendirse.
Los errores se devuelven al LLM en esta forma (contenido de texto en el resultado de la herramienta, 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_credentialsLos fallos a nivel de red (DNS, TCP, TLS, tiempo de espera) se muestran como:
Storm API error (HTTP 0, transport): request timeoutEl estado HTTP completo, el código de error de Storm y el mensaje humano siempre se incluyen para que el LLM pueda actuar sobre ellos.
Desarrollo
git clone https://github.com/lsudduth/storm-mcp.git
cd storm-mcp
npm install
npm testApunta a un servidor de desarrollo local de Storm sobrescribiendo la base de la API:
STORM_API_BASE=http://localhost:8080/api/v1 \
STORM_API_KEY=stk_dev_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx \
node src/index.mjsEl servidor habla MCP stdio, por lo que puedes manejarlo directamente con cualquier arnés de prueba MCP o canalizando marcos JSON-RPC manualmente.
Las pruebas utilizan el ejecutor de pruebas integrado de Node; sin Jest, sin Vitest, sin transpilador.
Licencia
MIT — ver LICENSE.
© 2026 XCH1TB, LLC dba Eyewall Markets.
Storm en sí mismo — el agente de IA autónomo que opera Eyewall Markets y produce los datos que este servidor expone — es una base de código interna separada. Este paquete es solo el puente MCP orientado al cliente hacia la superficie de la API pública de solo lectura de Storm.
Descargo de responsabilidad
Este software y los datos que muestra se proporcionan solo con fines informativos. Nada de lo devuelto por Storm o por este servidor MCP constituye asesoramiento legal, financiero, fiscal o de inversión. La participación en mercados de predicción está sujeta a tus leyes locales y a las propias reglas de elegibilidad de la plataforma; en particular, Polymarket está restringido en los Estados Unidos bajo órdenes de la CFTC y no está disponible para la mayoría de las personas estadounidenses. La elegibilidad de la plataforma es tu responsabilidad, no de Storm ni de este servidor. Storm agrega el estado del mercado observable públicamente y no realiza operaciones en tu nombre.
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