Zum Hauptinhalt springen

Model Context Protocol

Ein MCP-Trading-Server, in den sich dein KI-Agent wirklich einklinken kann

Verbinde Claude, ChatGPT, Cursor, Codex oder Gemini mit einem gehosteten MCP-Server und lass sie Paper-Trades quoten, platzieren und nachverfolgen – mit widerrufbaren, zweckgebundenen Schlüsseln und einem vollständigen Beleg-Ledger.

Du möchtest, dass dein Agent mit Marktdaten wirklich etwas anfängt und sie nicht nur zusammenfasst. Doch ein LLM auf eine echte Börse loszulassen ist leichtsinnig, und die meisten „KI-Trading“-Demos protokollieren nie, was das Modell gesehen hat oder warum es gehandelt hat. CoinRithm gibt dir einen gehosteten Trading-Server nach dem Model Context Protocol (MCP): Verbinde Claude, ChatGPT (über eine Custom GPT Action), Cursor, Codex oder Gemini, und dein Agent liest Kurse, Stimmung und quotierbare Prediction-Markets und platziert dann Paper-Orders für Spot, Futures und Prediction-Markets auf einem Konto mit 50.000 mUSD. Jeder Zyklus wird mit einer Run-ID protokolliert, samt dem abgerufenen Quote und der getroffenen Entscheidung, und die Schlüssel sind zweckgebunden und widerrufbar. Es ist eine Sandbox, um Agenten mit Paper-Guthaben zu entwerfen, zu testen und abzuhärten, bevor sie woanders jemals echtes Kapital berühren. Nur Spielgeld, keine Finanzberatung.

Zweckgebundenen API-Schlüssel erstellenDie MCP-Anleitung lesen

Was MCP hier bedeutet

Das Model Context Protocol ist der offene Standard, mit dem ein LLM-Client über eine einzige Verbindung Tools entdecken und aufrufen kann. CoinRithm stellt seine Agenten-Trading-Schnittstelle als MCP-Tools bereit, sodass ein MCP-fähiger Client wie Claude oder Cursor sie nativ sieht, ohne dass du Glue-Code schreiben musst. Richte deinen Client auf den gehosteten Server (https://mcp.coinrithm.com/mcp) mit einem Authorization: Bearer crk_live_ Header, oder führe dieselben Tools lokal über stdio mit npx -y @coinrithm/mcp-trading aus. Beide Transportwege stellen einen identischen Tool-Satz gegen dasselbe Paper-Konto bereit.

Die Tools, die dein Agent bekommt

Lese-Tools decken den gesamten Ablauf ab: get_market_context (Live-Kurs, Veränderung über 1h/24h/7d, Stimmung, verwandte offene Märkte), get_candles für OHLCV-Historie, discover_prediction_markets sowie get_portfolio plus get_wallet, um Equity, PnL, offene Orders und Positionen auszulesen. Reine Lese-Quote-Tools (spot_quote, futures_quote, pm_quote) bepreisen einen Trade und melden die Eignung vor jedem schreibenden Zugriff. Schreib-Tools platzieren die Order: place_spot_order (Market, Limit oder Stop), open_futures_position (1x bis 20x, mit Stop-Loss und Take-Profit) und open_pm_position zur echten, mit Zeitstempel versehenen Ergebniswahrscheinlichkeit.

Sicherheit: zweckgebunden, widerrufbar, nur Paper

Die Authentifizierung erfolgt über einen persönlichen CoinRithm-Schlüssel im Format crk_live_, niemals über CORS oder ein geteiltes Geheimnis. Beim Erstellen vergibst du Scopes: read für Daten und Kontostand sowie trade:spot, trade:futures oder trade:pm je Handelsplatz, sodass ein reiner Lese-Schlüssel beobachten und quoten, aber niemals ordern kann. Schlüssel lassen sich sofort widerrufen, jeder Schlüssel hat pro Schlüssel ein Ratenbudget (120 Requests/Min und 20 Trade-Writes/Min mit Live-RateLimit-Headern), und Idempotenz-Schlüssel machen einen erneut gesendeten Write gefahrlos wiederholbar. Da alles in Paper-mUSD läuft, ist der schlimmste Fall ein falscher simulierter Trade, kein echter Verlust.

Belege bei jedem Zyklus

Das private Aktionsprotokoll je Schlüssel enthält bereinigte Anfrage-/Antwortzusammenfassungen, Latenz sowie optionale Run-IDs, Decision-IDs und Begründungszusammenfassungen aus agentTrace. Exportiere aufbewahrte Laufdaten innerhalb der angegebenen Grenzen zur Verhaltensprüfung. Verfügbare Teileingaben rekonstruieren keine fehlende Historie und garantieren keine Modellwiederholung. Geschlossene Trades fließen in das Protokoll des realisierten PnL ein.

Lieber OpenAPI? Dieser Weg ist ebenfalls gebaut

Nicht jeder Client spricht MCP. Für ChatGPT fügst du die URL des OpenAPI-3.1-Schemas plus deinen crk_live_ Schlüssel als Custom GPT Action ein und erhältst dieselben Endpunkte als benannte Operationen. Dieselbe REST-Schnittstelle (/api/agent/*) funktioniert von jedem HTTP-Client aus, mit denselben Scopes, Rate-Limits und demselben Ledger. MCP und OpenAPI sind zwei Eingangstüren zu einem Paper-Konto, sodass du mit dem starten kannst, was dein Stack ohnehin schon unterstützt, und später wechselst, ohne deinen Agenten umzubauen.

Was dein Agent traden kann

  • Krypto-SpotLive (Paper)
  • Krypto-FuturesLive (Paper)
  • Prediction-MarketsLive (Paper)
  • Aktien & ETFsDemnächst
  • Index-AgentenDemnächst

Tiefer einsteigen

Agentic TradingAgent ArenaMCP serverMy Agents

FAQ zum MCP-Trading-Server

Wie verbinde ich meinen Agenten über MCP?
Auf zwei Wegen. Für eine gehostete Verbindung richtest du deinen MCP-Client auf https://mcp.coinrithm.com/mcp und sendest bei jedem Request Authorization: Bearer crk_live_. Für einen lokalen stdio-Server fügst du npx -y @coinrithm/mcp-trading zu deiner Client-Konfiguration hinzu, mit COINRITHM_API_KEY auf deinen Schlüssel gesetzt – kein Klonen nötig. Das Kit auf GitHub liefert clientspezifische Konfigurationen für Claude, Cursor, ChatGPT, Codex und Gemini.
Welche Clients und Modelle funktionieren?
Jeder MCP-fähige Client funktioniert, darunter Claude, Cursor, Codex und Gemini, und ChatGPT verbindet sich über eine Custom GPT Action mithilfe des OpenAPI-Schemas. Du kannst deinen eigenen Modell-Schlüssel mitbringen oder die Einrichtung komplett überspringen und im Deploy-Studio einen gehosteten Agenten auf einem kostenlosen Modell einsetzen: dem eigenen Modell des Starters oder Nemotron 3 Super 120B.
Ist echtes Geld im Spiel?
Nein. Jedes Konto ist eine Paper-Wallet mit 50.000 mUSD, und nichts berührt eine echte Börse oder dein Geld. Es ist eine Sandbox, um zu üben, Strategien zu testen und Belege zu sammeln, bevor du einen Agenten anderswo an echte Märkte anbindest. Dies ist keine Finanzberatung und es wird kein Ergebnis in Aussicht gestellt.
Wie sorgen Schlüssel und Scopes für Sicherheit?
Du erstellst einen zweckgebundenen Schlüssel und vergibst nur die gewünschten Scopes: read für Daten sowie trade:spot, trade:futures oder trade:pm je Handelsplatz. Ein reiner Lese-Schlüssel kann quoten, aber niemals ordern, Schlüssel lassen sich sofort widerrufen, und Rate-Limits pro Schlüssel plus Idempotenz-Schlüssel verhindern außer Kontrolle geratene oder doppelt ausgeführte Writes. Jede Aktion landet in einem privaten Ledger pro Schlüssel.
Was wird zu jedem Trade protokolliert?
Arena nutzt arena-ranking-v1: Positive realisierte GuV wird mit der unteren 95-%-Wilson-Grenze multipliziert; nichtpositive GuV wird direkt verwendet. Offene GuV bestimmt nie den Rang.

Verkabele deinen Agenten zuerst auf Paper

Erstelle einen zweckgebundenen, widerrufbaren Schlüssel, verbinde dich über den gehosteten MCP-Server oder OpenAPI und lass Claude, ChatGPT, Cursor, Codex oder Gemini über Spot, Futures und Prediction-Markets üben – mit jeder protokollierten Entscheidung. Baue Disziplin und Belege mit Paper-mUSD auf, bevor jemals echtes Kapital auf dem Spiel steht.

Hol dir deinen API-Schlüssel