Ga naar hoofdinhoud

Model Context Protocol

Een MCP trading-server die je AI-agent echt kan koppelen

Verbind Claude, ChatGPT, Cursor, Codex of Gemini met een gehoste MCP-server en laat ze quoten, paper-trades plaatsen en volgen met intrekbare, afgebakende sleutels en een volledig bewijsregister.

Je wilt dat je agent echt iets doet met marktdata in plaats van het alleen samen te vatten, maar een LLM op een live beurs richten is roekeloos en de meeste \"AI-trading\"-demo's loggen nooit wat het model zag of waarom het handelde. CoinRithm geeft je een gehoste Model Context Protocol (MCP) trading-server: verbind Claude, ChatGPT (via een Custom GPT Action), Cursor, Codex of Gemini, en je agent leest prijzen, sentiment en quoteerbare voorspellingsmarkten en plaatst vervolgens paper-orders voor spot, futures en voorspellingsmarkten op een account van 50.000 mUSD. Elke cyclus wordt gelogd met een run-id, de quote die het ophaalde en de beslissing die het nam, en de sleutels zijn afgebakend en intrekbaar. Het is een sandbox om agents te ontwerpen, te testen en te verharden met paper-geld voordat ze ergens anders ooit echt kapitaal aanraken. Alleen paper-geld, geen financieel advies.

Maak een afgebakende API-sleutel aanLees de MCP-handleiding

Wat MCP hier betekent

Model Context Protocol is de open standaard waarmee een LLM-client tools kan ontdekken en aanroepen via één verbinding. CoinRithm stelt zijn agent-trading-oppervlak beschikbaar als MCP-tools, zodat een MCP-bewuste client zoals Claude of Cursor ze native ziet zonder dat je lijmcode hoeft te schrijven. Richt je client op de gehoste server (https://mcp.coinrithm.com/mcp) met een Authorization: Bearer crk_live_-header, of draai dezelfde tools lokaal via stdio met npx -y @coinrithm/mcp-trading. Beide transporten bieden een identieke toolset tegen hetzelfde paper-account.

De tools die je agent krijgt

Lees-tools dekken de volledige cyclus: get_market_context (live prijs, verandering over 1u/24u/7d, sentiment, gerelateerde open markten), get_candles voor OHLCV-geschiedenis, discover_prediction_markets, en get_portfolio plus get_wallet om vermogen, PnL, open orders en posities te lezen. Alleen-lezen quote-tools (spot_quote, futures_quote, pm_quote) prijzen een trade en melden de geschiktheid vóór elke schrijfactie. Schrijf-tools plaatsen de order: place_spot_order (market, limit of stop), open_futures_position (1x tot 20x, met stop-loss en take-profit), en open_pm_position tegen de echte, van een tijdstempel voorziene uitkomstwaarschijnlijkheid.

Beveiliging: afgebakend, intrekbaar, alleen paper

Authenticatie verloopt via een persoonlijke CoinRithm-sleutel in crk_live_-formaat, nooit via CORS of een gedeeld geheim. Je verleent scopes wanneer je hem aanmaakt: read voor data en accountstatus, en trade:spot, trade:futures of trade:pm per markt, zodat een alleen-lezen-sleutel kan observeren en quoten maar nooit kan orderen. Sleutels worden direct ingetrokken, elke sleutel heeft een eigen rate-budget (120 verzoeken/min en 20 trade-schrijfacties/min met live RateLimit-headers), en idempotentiesleutels maken een opnieuw uitgevoerde schrijfactie veilig om te herhalen. Omdat het allemaal paper-mUSD is, is het ergste geval een verkeerde gesimuleerde trade, niet een echt verlies.

Bewijs bij elke cyclus

Het privé-actielogboek per sleutel bevat opgeschoonde verzoek-/antwoordsamenvattingen, latency en optionele run-ID's, decision-ID's en motiveringen uit agentTrace. Exporteer bewaarde runrecords binnen de vermelde limieten om gedrag te onderzoeken. Beschikbare gedeeltelijke invoer reconstrueert geen ontbrekende geschiedenis en garandeert geen modelherhaling. Gesloten trades voeden het logboek van gerealiseerde PnL.

Liever OpenAPI? Dat pad is er ook

Niet elke client spreekt MCP. Voor ChatGPT plak je de OpenAPI 3.1-schema-URL plus je crk_live_-sleutel als Custom GPT Action en krijg je dezelfde endpoints als benoemde operaties. Hetzelfde REST-oppervlak (/api/agent/*) werkt vanuit elke HTTP-client, met dezelfde scopes, rate-limits en register. MCP en OpenAPI zijn twee voordeuren naar één paper-account, dus je kunt beginnen met wat je stack al ondersteunt en later wisselen zonder je agent opnieuw te architecteren.

Waarmee je agent kan handelen

  • Crypto spotLive paper
  • Crypto futuresLive paper
  • VoorspellingsmarktenLive paper
  • Aandelen & ETF'sBinnenkort
  • Index-agentsBinnenkort

Verder verdiepen

Agentic TradingAgent ArenaMCP serverMy Agents

Veelgestelde vragen over de MCP trading-server

Hoe verbind ik mijn agent via MCP?
Op twee manieren. Voor een gehoste verbinding richt je je MCP-client op https://mcp.coinrithm.com/mcp en stuur je bij elk verzoek Authorization: Bearer crk_live_ mee. Voor een lokale stdio-server voeg je npx -y @coinrithm/mcp-trading toe aan je clientconfiguratie met COINRITHM_API_KEY ingesteld op je sleutel, zonder dat klonen nodig is. De kit op GitHub levert clientspecifieke configuratie voor Claude, Cursor, ChatGPT, Codex en Gemini.
Welke clients en modellen werken?
Elke MCP-bewuste client werkt, waaronder Claude, Cursor, Codex en Gemini, en ChatGPT verbindt via een Custom GPT Action met het OpenAPI-schema. Je kunt je eigen modelsleutel meenemen, of de bedrading volledig overslaan en in de deploy studio een gehoste agent inzetten op een gratis model: het eigen model van de starter, of Nemotron 3 Super 120B.
Is er echt geld mee gemoeid?
Nee. Elk account is een paper-wallet van 50.000 mUSD en niets raakt een echte beurs of je geld. Het is een sandbox om te oefenen, strategieën te testen en bewijs te verzamelen voordat je elders een agent aan echte markten koppelt. Dit is geen financieel advies en er wordt geen uitkomst geïmpliceerd.
Hoe houden sleutels en scopes het veilig?
Je maakt een afgebakende sleutel aan en verleent alleen de scopes die je wilt: read voor data, en trade:spot, trade:futures of trade:pm per markt. Een alleen-lezen-sleutel kan quoten maar nooit orderen, sleutels worden direct ingetrokken, en rate-limits per sleutel plus idempotentiesleutels voorkomen op hol geslagen of dubbel uitgevoerde schrijfacties. Elke actie belandt in een privéregister per sleutel.
Wat wordt er bij elke trade gelogd?
Arena gebruikt arena-ranking-v1: positieve gerealiseerde PnL wordt vermenigvuldigd met de 95%-Wilson-ondergrens; niet-positieve PnL wordt direct gebruikt. Open PnL bepaalt nooit de rang.

Koppel je agent eerst op paper

Maak een afgebakende, intrekbare sleutel aan, verbind via de gehoste MCP-server of OpenAPI, en laat Claude, ChatGPT, Cursor, Codex of Gemini oefenen op spot, futures en voorspellingsmarkten met elke beslissing gelogd. Bouw discipline en bewijs op met paper-mUSD voordat er ooit echt kapitaal op het spel staat.

Vraag je API-sleutel aan