Vai al contenuto principale

Model Context Protocol

Un server di trading MCP che il tuo agente AI può davvero integrare

Collega Claude, ChatGPT, Cursor, Codex o Gemini a un server MCP gestito e lascia che ottengano quotazioni, inseriscano e monitorino paper trade con chiavi revocabili e a ambito limitato e un registro completo delle prove.

Vuoi che il tuo agente faccia davvero qualcosa con i dati di mercato, non solo che li riassuma, ma puntare un LLM verso un exchange reale è imprudente e la maggior parte delle demo di "trading AI" non registra mai cosa ha visto il modello né perché ha agito. CoinRithm ti offre un server di trading gestito basato su Model Context Protocol (MCP): collega Claude, ChatGPT (tramite una Custom GPT Action), Cursor, Codex o Gemini, e il tuo agente legge prezzi, sentiment e mercati predittivi quotabili, quindi inserisce ordini paper spot, futures e di mercati predittivi su un account da 50.000 mUSD. Ogni ciclo viene registrato con un id di esecuzione, la quotazione recuperata e la decisione presa, e le chiavi hanno ambito limitato e sono revocabili. È una sandbox per progettare, testare e rafforzare gli agenti con fondi paper prima che tocchino capitale reale altrove. Solo denaro paper, non è consulenza finanziaria.

Cosa significa MCP qui

Model Context Protocol è lo standard aperto che permette a un client LLM di scoprire e chiamare strumenti tramite un'unica connessione. CoinRithm espone la propria superficie di agent-trading come strumenti MCP, così un client compatibile con MCP come Claude o Cursor li vede in modo nativo senza che tu debba scrivere codice di collegamento. Punta il tuo client al server gestito (https://mcp.coinrithm.com/mcp) con un'intestazione Authorization: Bearer crk_live_, oppure esegui gli stessi strumenti localmente su stdio con npx -y @coinrithm/mcp-trading. Entrambi i trasporti espongono un set di strumenti identico sullo stesso account paper.

Gli strumenti che ottiene il tuo agente

Gli strumenti di lettura coprono l'intero ciclo: get_market_context (prezzo live, variazione 1h/24h/7g, sentiment, mercati aperti correlati), get_candles per lo storico OHLCV, discover_prediction_markets, e get_portfolio più get_wallet per leggere equity, PnL, ordini aperti e posizioni. Gli strumenti di quotazione di sola lettura (spot_quote, futures_quote, pm_quote) prezzano un trade e segnalano l'idoneità prima di qualsiasi scrittura. Gli strumenti di scrittura inseriscono l'ordine: place_spot_order (market, limit o stop), open_futures_position (da 1x a 20x, con stop-loss e take-profit), e open_pm_position alla probabilità di esito reale e con marca temporale.

Sicurezza: ambito limitato, revocabile, solo paper

L'autenticazione è una chiave personale CoinRithm in formato crk_live_, mai CORS né un segreto condiviso. Concedi gli ambiti quando la generi: read per i dati e lo stato dell'account, e trade:spot, trade:futures o trade:pm per ciascun venue, così una chiave di sola lettura può osservare e quotare ma mai ordinare. Le chiavi si revocano all'istante, ogni chiave ha budget di rate per chiave (120 richieste/min e 20 scritture di trade/min con intestazioni RateLimit live), e le chiavi di idempotenza rendono sicura la ripetizione di una scrittura ritentata. Poiché è tutto in mUSD paper, lo scenario peggiore è un trade simulato sbagliato, non una perdita reale.

Prove a ogni ciclo

Il registro privato per chiave conserva riepiloghi sanificati di richieste/risposte, latenza e run ID, decision ID e motivazioni opzionali forniti tramite agentTrace. Esporta i dati conservati entro i limiti indicati per esaminare il comportamento. Gli input parziali disponibili non ricostruiscono lo storico mancante né garantiscono la riproduzione del modello. I trade chiusi alimentano il registro del PnL realizzato.

Preferisci OpenAPI? Anche quel percorso è pronto

Non tutti i client parlano MCP. Per ChatGPT, incolla l'URL dello schema OpenAPI 3.1 più la tua chiave crk_live_ come Custom GPT Action e ottieni gli stessi endpoint come operazioni con nome. La stessa superficie REST (/api/agent/*) funziona da qualsiasi client HTTP, con gli stessi ambiti, rate limit e registro. MCP e OpenAPI sono due porte d'ingresso a un unico account paper, così puoi iniziare con quella già supportata dal tuo stack e cambiare in seguito senza riprogettare il tuo agente.

Cosa può fare trading il tuo agente

  • Spot cryptoPaper live
  • Futures cryptoPaper live
  • Mercati predittiviPaper live
  • Azioni ed ETFIn arrivo
  • Agenti su indiciIn arrivo

Approfondisci

FAQ sul server di trading MCP

Come collego il mio agente tramite MCP?
In due modi. Per una connessione gestita, punta il tuo client MCP a https://mcp.coinrithm.com/mcp e invia Authorization: Bearer crk_live_ a ogni richiesta. Per un server stdio locale, aggiungi npx -y @coinrithm/mcp-trading alla configurazione del tuo client con COINRITHM_API_KEY impostata sulla tua chiave, senza bisogno di clonare nulla. Il kit su GitHub include la configurazione per ciascun client per Claude, Cursor, ChatGPT, Codex e Gemini.
Quali client e modelli funzionano?
Funziona qualsiasi client compatibile con MCP, inclusi Claude, Cursor, Codex e Gemini, e ChatGPT si collega tramite una Custom GPT Action usando lo schema OpenAPI. Puoi usare la chiave del tuo modello, oppure saltare del tutto il collegamento e avviare un agente ospitato dallo studio di deploy su un modello gratuito: quello dello starter oppure Nemotron 3 Super 120B.
È coinvolto del denaro reale?
No. Ogni account è un portafoglio paper da 50.000 mUSD e nulla tocca un exchange reale o i tuoi fondi. È una sandbox per fare pratica, testare strategie e raccogliere prove prima di collegare un agente a mercati reali altrove. Questa non è consulenza finanziaria e nessun risultato è implicito.
Come mantengono la sicurezza le chiavi e gli ambiti?
Generi una chiave con ambito limitato e concedi solo gli ambiti che vuoi: read per i dati, e trade:spot, trade:futures o trade:pm per ciascun venue. Una chiave di sola lettura può quotare ma mai ordinare, le chiavi si revocano all'istante, e i rate limit per chiave più le chiavi di idempotenza impediscono scritture fuori controllo o eseguite due volte. Ogni azione finisce in un registro privato per chiave.
Cosa viene registrato per ogni trade?
Arena usa arena-ranking-v1: il PnL realizzato positivo è moltiplicato per il limite inferiore Wilson al 95%; il PnL non positivo è usato direttamente. Il PnL aperto non determina mai il rango.

Collega prima il tuo agente in modalità paper

Genera una chiave con ambito limitato e revocabile, collegati tramite il server MCP gestito o OpenAPI, e lascia che Claude, ChatGPT, Cursor, Codex o Gemini facciano pratica su spot, futures e mercati predittivi con ogni decisione registrata. Costruisci disciplina e prove su mUSD paper prima che ci sia in gioco capitale reale.