Server MCP
Il server MCP (Model Context Protocol) di PolyTest permette a uno strumento di IA di leggere direttamente i dati di mercato di PolyTest. Funziona in Claude Code, Cursor, VS Code, Codex, Gemini CLI, Claude Desktop e in altri client MCP. Tutti i suoi strumenti sono in sola lettura.
Connessione
Il server ospitato si trova su https://mcp.polytest.io/mcp e usa Streamable HTTP. Il comando di Claude Code aggiunge il server senza chiave, poi accedi con il tuo account PolyTest. Gli altri esempi inviano una chiave API letta dalla variabile d’ambiente POLYTEST_KEY. Autenticazione spiega entrambe le opzioni.
claude mcp add --transport http polytest https://mcp.polytest.io/mcp{
"mcpServers": {
"polytest": {
"url": "https://mcp.polytest.io/mcp",
"headers": {
"Authorization": "Bearer ${env:POLYTEST_KEY}"
}
}
}
}{
"mcpServers": {
"polytest": {
"type": "http",
"url": "https://mcp.polytest.io/mcp",
"headers": {
"Authorization": "Bearer ${POLYTEST_KEY}"
}
}
}
}[mcp_servers.polytest]
url = "https://mcp.polytest.io/mcp"
bearer_token_env_var = "POLYTEST_KEY"gemini mcp add --transport http --header "Authorization: Bearer $POLYTEST_KEY" polytest https://mcp.polytest.io/mcpEsegui le righe di Claude Code e Gemini CLI in un terminale. Il blocco di Cursor va in ~/.cursor/mcp.json, quello di VS Code in .mcp.json e quello di Codex in ~/.codex/config.toml.
Autenticazione
Se il tuo client supporta OAuth, accedi con il tuo account PolyTest. In Claude Code, esegui /mcp, seleziona polytest e scegli Authenticate. Se /mcp non è disponibile, come in Claude Code all’interno dell’app desktop, esegui claude mcp login polytest in un terminale, dalla cartella in cui hai aggiunto il server. Gli altri client ti chiedono di accedere quando si collegano o la prima volta che chiamano uno strumento.
Il browser apre un link di accesso su qpzofvjvtdvdnvgpxplg.supabase.co, l’indirizzo di Supabase Auth, il servizio che PolyTest usa per l’accesso. Poi prosegue su www.polytest.io, dove approvi la connessione. In seguito puoi rimuoverla in Impostazioni, alla voce App collegate.
Puoi anche inviare una chiave API nell’header Authorization: Bearer <key>. Funziona anche X-API-Key. Crea una chiave nella pagina delle chiavi API e non inserirla mai nell’URL.
In Claude Code la chiave va nell’opzione --header:
claude mcp add --transport http polytest https://mcp.polytest.io/mcp --header "Authorization: Bearer $POLYTEST_KEY"Esecuzione in locale
npx -y @polytest/mcp esegue il server sul tuo computer dal pacchetto npm @polytest/mcp. Richiede Node 20 o versioni successive e legge la tua chiave dalla variabile d’ambiente POLYTEST_KEY.
claude mcp add --transport stdio --env POLYTEST_KEY=$POLYTEST_KEY polytest -- npx -y @polytest/mcp{
"mcpServers": {
"polytest": {
"command": "npx",
"args": ["-y", "@polytest/mcp"],
"env": {
"POLYTEST_KEY": "pt_live_..."
}
}
}
}Il blocco di Claude Desktop va in claude_desktop_config.json. Sostituisci pt_live_... con la tua chiave.
Strumenti
Il server ha cinque strumenti. L’ultima colonna indica quante richieste API costa una chiamata.
| Strumento | Restituisce | Richieste API |
|---|---|---|
polytest_list_markets | I mercati di un market_type per una moneta, prima i più recenti. Ogni riga riporta la finestra, lo status, il prezzo spot di apertura e di chiusura, il vincitore e il volume. | 1 |
polytest_get_market | Un singolo mercato, tramite market_id o slug, con gli id dei token e i campi di risoluzione. | 1 |
polytest_get_snapshots | Gli snapshot di un mercato, prima i più vecchi, ciascuno con time, spot_price, price_up e price_down. Con include_orderbook ogni riga contiene anche entrambi gli order book. | 1 |
polytest_get_price_series | Punti di prezzo a intervalli regolari lungo un mercato, prima i più vecchi. | 1 più una per campione, 21 con il valore predefinito |
polytest_get_limits | I limiti del tuo piano: livello, rate limit, tetto di concorrenza, accesso ai dati, tetto di chiavi e budget di prova. | 1 |
price_up è l’ask più basso nell’order book di Up: il prezzo che pagheresti per comprare Up in quel momento. price_down è lo stesso per Down. Entrambi vanno da 0 a 1 e valgono null quando nessuno offre quel lato. Nessuno dei due è un prezzo medio o il prezzo dell’ultimo scambio. Dato che sono entrambi ask, Up più Down di solito somma poco più di 1.
Una sessione tipica chiama polytest_list_markets per trovare un mercato, polytest_get_price_series per vederne l’andamento e poi polytest_get_snapshots per il dettaglio tick per tick o per l’order book in un dato momento.
Copertura e aggiornamento dei dati
PolyTest ha mercati btc, eth e sol per 5m, 15m e 1hr, e solo btc per 4hr e 24hr.
PolyTest carica i nuovi mercati a blocchi, quindi i mercati più recenti possono essere indietro di ore o giorni rispetto al tempo reale. Il ritardo varia in base alla moneta e al tipo di mercato.
Ogni riga di mercato ha un campo status:
upcoming: la finestra non è ancora iniziata.open: la finestra è ancora in corso.resolved: il vincitore è noto.ended_no_result: la finestra è chiusa e PolyTest non ne ha il risultato.
Quando elenchi i mercati più recenti, senza end_time, e il più recente è iniziato molto prima dell’ora attuale, polytest_list_markets aggiunge una nota che lo segnala. Per un mercato ancora in corso, polytest_get_price_series si ferma all’ora attuale invece di campionare il futuro. Quando gli ultimi bucket di una serie tornano vuoti, indica dove finiscono i dati. Un intervallo che inizia dopo l’ora attuale, come un mercato non ancora iniziato, restituisce un errore.
Limiti e costo
Ogni chiamata a uno strumento esegue normali richieste API, quindi conta per gli stessi limiti del piano delle chiamate REST.
- I rate limit sono per chiave, quindi crea una chiave dedicata per il server MCP.
- La concorrenza è condivisa con tutto ciò che è in esecuzione sul tuo account. Il server riprova per un breve momento quando non c’è uno slot libero.
polytest_get_limitsrestituiscetrial_budgetper ogni account, compresi quelli a pagamento. Sono i totali di richieste, record e byte che una prova gratuita può usare nei suoi 3 giorni, e valgono solo durante la prova. Gli strumenti non mostrano quanto resta: l’API REST comunica le quantità rimanenti solo negli header di risposta, che i client MCP non vedono.- I risultati sono dimensionati per la finestra di contesto di un’IA: le pagine sono piccole e gli order book vengono tagliati a una profondità scelta. Per scaricare grandi volumi o fare backtest, chiedi all’IA di scrivere codice con l’SDK TypeScript o con l’API REST.
Provalo
Con il server collegato, chiedi in linguaggio naturale. Per esempio:
Elenca i cinque mercati BTC 5m più recenti su PolyTest e mostra come si è mosso il prezzo di Up nell’ultimo.
Trova l’ultimo mercato BTC 15m risolto su PolyTest e mostra entrambi gli order book trenta secondi prima della chiusura.
Controlla i limiti del mio piano PolyTest e dimmi quante richieste API costa una serie di prezzi da 40 campioni.
Risoluzione dei problemi
- Un errore dello strumento dice che la chiave API manca o è stata rifiutata
- L’errore spiega come risolvere nella tua configurazione: imposta
POLYTEST_KEY, aggiungi l’headerAuthorizationoppure accedi di nuovo. Le tue chiavi sono nella pagina delle chiavi API. - Un errore dello strumento cita il tuo piano
- Il piano non copre quella richiesta. Chiedi all’IA di chiamare
polytest_get_limitsper vedere che cosa copre. - Il client dice che il server richiede l’autenticazione
- Accedi quando il client lo propone, oppure aggiungi l’header
Authorizationindicato in Autenticazione. - Un errore dello strumento dice che è stato raggiunto il rate limit
- L’errore indica quanto aspettare prima di riprovare.