Skip to main content
Glama
storm-mcp

storm-mcp

by xch1tbllc

storm-mcp

MCP-Server, der die Storm-API für plattformübergreifende Prognosemarkt-Intelligenz für jeden Model Context Protocol-Client verfügbar macht.

Storm ist der autonome KI-Agent, der Eyewall Markets betreibt, einen plattformübergreifenden Dienst für Prognosemarkt-Intelligenz, der Polymarket, Kalshi, Manifold, Futuur, Betfair, ForecastEx und mehr umfasst. Dieses Paket ist eine schlanke stdio-MCP-Brücke, die es LLM-Clients – Claude Desktop, Claude Code, Cursor, Zed und jedem anderen MCP-fähigen Host – ermöglicht, Storms kanonische Ereignisse, plattformübergreifende Spreads, den Plattformkatalog und den Posteingang für benutzerbezogene Warnmeldungen als native Tool-Aufrufe zu lesen.

Es richtet sich an Analysten, Trader und Agent-Entwickler, die bereits ein Storm-Abonnement besitzen und möchten, dass ihre LLM-Arbeitsumgebung sieht, was Storm sieht.


Edge-Tarif erforderlich

Die Storm-API ist auf Edge-Tarif-Abonnenten (499 $/Monat) beschränkt. Generieren Sie Ihren api_key unter https://eyewallmarkets.com/account. Niedrigere Tarife haben keinen API-Zugriff und erhalten bei jedem Endpunkt, den dieser Server aufruft, einen HTTP 403-Fehler.

API-Schlüssel sind als stk_ gefolgt von 48 Hexadezimalzeichen (insgesamt 52 Zeichen) formatiert und an ein einzelnes Konto gebunden. Behandeln Sie diese wie jede andere Inhaber-Anmeldeinformation.

Die vollständige API-Referenz finden Sie unter https://eyewallmarkets.com/api/docs.


Related MCP server: pmxt-mcp

Schnellstart — Claude Desktop

Bearbeiten Sie Ihre Claude Desktop MCP-Konfigurationsdatei und fügen Sie einen storm-Eintrag unter mcpServers hinzu:

{
  "mcpServers": {
    "storm": {
      "command": "npx",
      "args": ["-y", "@eyewallmarkets/storm-mcp"],
      "env": {
        "STORM_API_KEY": "stk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

Der macOS-Pfad lautet:

~/Library/Application Support/Claude/claude_desktop_config.json

Linux: ~/.config/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json.

Starten Sie Claude Desktop neu. Die sieben storm_*-Tools sollten in der Tool-Liste innerhalb jeder neuen Konversation erscheinen.


Schnellstart — Claude Code

claude mcp add storm npx -- -y @eyewallmarkets/storm-mcp

Exportieren Sie dann den API-Schlüssel in die Umgebung, in der Claude Code den Server startet (oder setzen Sie ihn in Ihrem Shell-Profil):

export STORM_API_KEY=stk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Der genaue CLI-Aufruf kann je nach Claude Code-Version variieren; siehe die offizielle Dokumentation unter https://docs.claude.com/en/docs/claude-code/mcp für die kanonische Form (einschließlich der Art und Weise, wie Umgebungsvariablen in der mcp add-Zeile selbst übergeben werden).

Führen Sie nach der Installation /mcp innerhalb von Claude Code aus, um zu bestätigen, dass der storm-Server verbunden ist und die sieben Tools registriert sind.


Schnellstart — Cursor

Cursor liest MCP-Serverdefinitionen aus ~/.cursor/mcp.json. Fügen Sie die gleiche Struktur hinzu, die für Claude Desktop verwendet wird:

{
  "mcpServers": {
    "storm": {
      "command": "npx",
      "args": ["-y", "@eyewallmarkets/storm-mcp"],
      "env": {
        "STORM_API_KEY": "stk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

Laden Sie die MCP-Integration von Cursor neu (Einstellungen → MCP → Aktualisieren).


Schnellstart — Zed

Zed konfiguriert MCP-Server unter assistant.context_servers in ~/.config/zed/settings.json:

{
  "assistant": {
    "context_servers": {
      "storm": {
        "command": "npx",
        "args": ["-y", "@eyewallmarkets/storm-mcp"],
        "env": {
          "STORM_API_KEY": "stk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
        }
      }
    }
  }
}

Starten Sie Zed neu oder laden Sie das Assistenten-Panel neu.


Konfiguration

Die gesamte Konfiguration erfolgt über Umgebungsvariablen, die beim Serverstart gelesen werden.

Variable

Erforderlich

Standard

Beschreibung

STORM_API_KEY

ja

—

Edge-Tarif API-Schlüssel, Format stk_<48 hex>. Ohne diesen startet der Server, aber jeder Tool-Aufruf schlägt fehl.

STORM_API_BASE

nein

https://eyewallmarkets.com/api/v1

Überschreiben der API-Basis-URL. Nützlich für Staging oder einen lokalen Entwicklungsserver.

STORM_HTTP_TIMEOUT

nein

15000

Timeout pro Anfrage in Millisekunden.

STORM_MCP_LOG_LEVEL

nein

info

Einer der Werte silent, error, warn, info, debug. Protokolle werden an stderr gesendet, damit sie den stdio-MCP-Transport nicht beschädigen.


Tool-Referenz

Alle sieben Tools sind schreibgeschützt und idempotent. Die Argumentstrukturen sind unten in einer JSON-Schema-ähnlichen Form dokumentiert; das Live-Schema ist das, was der MCP-Client tatsächlich sieht.

storm_list_events

Listet kanonische (plattformübergreifende) Ereignisse auf. Cursor-paginiert.

{
  "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"] }
}

Beispiel-Prompt: "Liste die nächsten 20 offenen politischen Ereignisse auf Storm auf."

storm_get_event

Ruft ein einzelnes Ereignis anhand des Slugs ab, einschließlich aller verknüpften Ergebnisse und Preise pro Plattform.

{
  "slug": { "type": "string", "required": true, "example": "us-pres-2028" }
}

Beispiel-Prompt: "Rufe den vollständigen Storm-Datensatz für us-pres-2028 ab und sage mir, welches Ergebnis den größten plattformübergreifenden Spread aufweist."

storm_list_spreads

Listet aktuelle plattformübergreifende Spreads auf, bei denen der Netto-Vorteil (nach Gebühren) den Mindestwert überschreitet. Sortiert nach Vorteil (DESC).

{
  "min_edge_bps": { "type": "integer", "default": 100 },
  "limit":        { "type": "integer", "default": 50, "max": 200 },
  "cursor":       { "type": "string",  "optional": true }
}

Beispiel-Prompt: "Zeige mir die Top 10 Storm-Spreads mit mindestens 250 Basispunkten Vorteil im Moment."

storm_get_market

Sucht einen einzelnen Plattform-/Marktdatensatz anhand von (venue_slug, external_id).

{
  "venue":       { "type": "string", "required": true, "example": "polymarket" },
  "external_id": { "type": "string", "required": true }
}

Beispiel-Prompt: "Suche den Polymarket-Markt 0xabc... auf Storm."

storm_list_venues

Listet jede von Storm verfolgte Plattform auf, mit regulatorischem Status (CFTC-registriertes DCM, Offshore usw.), Gebührenstrukturen und Fähigkeits-Flags (Orderbuch, AMM, Parimutuel).

{}

Beispiel-Prompt: "Welche von Storm verfolgten Plattformen sind CFTC-registrierte DCMs?"

storm_get_alerts_inbox

Fragt den API-Kanal-Posteingang für Warnmeldungen des Benutzers ab. Edge-Abonnenten können Warnmeldungen an den api-Zustellungskanal weiterleiten; dieses Tool leert die nicht bestätigte Warteschlange.

{
  "since": { "type": "integer", "minimum": 0, "optional": true, "example": 4521 }
}

Der Cursor ist die Ganzzahl id der letzten Warnmeldung, die Sie gesehen haben. Übergeben Sie next_since aus der vorherigen Antwort, um nur neuere Warnmeldungen abzurufen; lassen Sie es weg, um ab dem gespeicherten Bestätigungs-Cursor des Benutzers zu lesen. Beispiel-Prompt: "Frage meinen Storm-Posteingang ab und fasse alles zusammen, was ich noch nicht bestätigt habe."

storm_ack_alerts

Setzt den persistenten Bestätigungs-Cursor vor, sodass zukünftige Posteingangsabfragen bereits behandelte Warnmeldungen überspringen. Der Cursor ist serverseitig und überlebt MCP-Sitzungen hinweg.

{
  "up_to": { "type": "integer", "minimum": 0, "required": true, "example": 4530 }
}

Beispiel-Prompt: "Bestätige alle Storm-Warnmeldungen bis jetzt."


Beispiel-Transkripte

Finden eines Spread-Clusters mit hohem Vorteil

Benutzer: Finde alle 2028-Wahl-Storm-Spreads mit einem Vorteil von über 300 Basispunkten und nenne mir die Top 3.

Assistent: (ruft storm_list_spreads mit min_edge_bps: 300, limit: 50 auf, filtert die Antwort nach dem Ereignis-Slug-Präfix 2028_us_presidential_, ruft dann storm_get_event für die Top 3 auf, um sie anzureichern)

Gibt die drei größten aktuell offenen 2028-Wahl-Spreads zurück, das Plattformpaar auf jeder Seite und welche Plattform den günstigen Teil hält.

Posteingangs-Triage

Benutzer: Frage meinen Storm-Posteingang ab und fasse nicht bestätigte Warnmeldungen zusammen, dann bestätige alles, was du zusammengefasst hast.

Assistent: (ruft storm_get_alerts_inbox ohne since auf, fasst die Elemente nach Kategorie zusammen, ruft dann storm_ack_alerts mit up_to auf die größte gesehene id auf)

Gibt eine kategorisierte Zusammenfassung nicht bestätigter Warnmeldungen zurück (Spread-Vorteils-Überschreitungen, Änderungen des Plattformstatus, Auflösungsereignisse) und bestätigt das Vorrücken des Cursors, sodass nachfolgende Abfragen nur neue Elemente zurückgeben.


Ratenbegrenzungen und Fehlerbehandlung

Die Storm-API erzwingt serverseitig 10 Anfragen pro Sekunde pro API-Schlüssel. Wenn Sie dies überschreiten, gibt der Server HTTP 429 mit Retry-After: 1 zurück. Diese MCP-Brücke führt keine automatischen Wiederholungsversuche durch; sie zeigt den Fehler dem LLM als Klartextinhalt im Tool-Ergebnis an, damit das Modell entscheiden kann, ob es warten, wiederholen oder aufgeben soll.

Fehler werden dem LLM in dieser Form zurückgegeben (Textinhalt im Tool-Ergebnis, 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_required
Storm API error (HTTP 401, invalid_credentials): invalid_credentials

Netzwerkfehler (DNS, TCP, TLS, Timeout) werden wie folgt angezeigt:

Storm API error (HTTP 0, transport): request timeout

Der vollständige HTTP-Status, der Storm-Fehlercode und die menschliche Nachricht sind immer enthalten, damit das LLM darauf reagieren kann.


Entwicklung

git clone https://github.com/lsudduth/storm-mcp.git
cd storm-mcp
npm install
npm test

Verweisen Sie auf einen lokalen Storm-Entwicklungsserver, indem Sie die API-Basis überschreiben:

STORM_API_BASE=http://localhost:8080/api/v1 \
STORM_API_KEY=stk_dev_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx \
node src/index.mjs

Der Server spricht stdio-MCP, sodass Sie ihn direkt mit jedem MCP-Test-Harness oder durch manuelles Weiterleiten von JSON-RPC-Frames steuern können.

Tests verwenden den integrierten Test-Runner von Node; kein Jest, kein Vitest, kein Transpiler.


Lizenz

MIT — siehe LICENSE.

© 2026 XCH1TB, LLC dba Eyewall Markets.

Storm selbst — der autonome KI-Agent, der Eyewall Markets betreibt und die Daten produziert, die dieser Server bereitstellt — ist eine separate, interne Codebasis. Dieses Paket ist nur die clientseitige MCP-Brücke zur öffentlichen, schreibgeschützten API-Oberfläche von Storm.


Haftungsausschluss

Diese Software und die von ihr bereitgestellten Daten werden nur zu Informationszwecken bereitgestellt. Nichts, was von Storm oder diesem MCP-Server zurückgegeben wird, stellt eine Rechts-, Finanz-, Steuer- oder Anlageberatung dar. Die Teilnahme an Prognosemärkten unterliegt Ihren lokalen Gesetzen und den eigenen Zulassungsregeln der Plattform; insbesondere ist Polymarket in den Vereinigten Staaten gemäß CFTC-Anordnungen eingeschränkt und für die meisten US-Personen nicht verfügbar. Die Zulassung zur Plattform liegt in Ihrer Verantwortung, nicht bei Storm und nicht bei diesem Server. Storm aggregiert öffentlich beobachtbare Marktstatus und platziert keine Trades in Ihrem Namen.

Available Tools

7 tools
storm_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

    A4.5/5.0

    Scored across 7 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness5/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      MCP-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.
      29
      18 PyPI
      MIT
    • A
      license
      C
      quality
      D
      maintenance
      MCP 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.
      32
      8
      MIT