Come collegare Deribit a Gemini via MCP

💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → Deribit, installalo senza chiave, genera una MCP API key e hai finito. Niente Docker, niente git clone, niente server locale.

Deribit + Gemini

Dati pubblici sui derivati crypto di Deribit: opzioni e future con open interest, volatilità implicita e mark price, indice DVOL, volatilità storica, ticker con greche, order book, candele, scambi, funding rate, prezzi di indici e consegna. Nessun account né chiave; sola lettura, niente trading.

Prerequisiti

Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:

(nessuna obbligatoria)

Step 1 — Configura il connettore

Dati pubblici, nessuna chiave: la configurazione richiede meno di un minuto. Il connettore legge i dati di mercato pubblici di Deribit, l'exchange di opzioni e future crypto, tramite la sua API JSON-RPC su HTTP (https://www.deribit.com/api/v2/public/...). I metodi pubblici non richiedono account né chiave.

1. Nello store dei connettori scegli Deribit e installalo. Non c'è nulla da compilare.
2. Verificalo con deribit_get_index_price_names: elenca gli indici di prezzo di Deribit come btc_usd e eth_usd.

Nomi: currency è BTC, ETH, USDC, USDT o EURR (deribit_get_currencies li elenca), oppure any dove uno strumento lo accetta. Un instrument_name è un perpetual BTC-PERPETUAL, un future BTC-27DEC26, un'opzione BTC-27DEC26-100000-C (valuta, scadenza, strike, C per call o P per put) o un perpetual lineare SOL_USDC-PERPETUAL; deribit_get_instruments elenca quelli attivi con scadenze, strike, tick size e dimensione del contratto. Un index_name è btc_usd, eth_usd, sol_usdc e così via.

Cosa legge: un riepilogo di tutti gli strumenti di una valuta in una sola chiamata (open interest, volume a 24 ore, bid, ask, mark price e ultimo prezzo, e per le opzioni la volatilità implicita mark), che basta per skew delle opzioni, open interest per strike e scadenza e max pain; lo stesso riepilogo per un solo strumento; il ticker di uno strumento con miglior bid e ask, open interest, funding per i perpetual e greche e volatilità implicite per le opzioni; l'order book; le candele OHLCV; gli ultimi scambi di uno strumento o di un'intera valuta, con block trade e liquidazioni segnalati; l'indice di volatilità implicita DVOL come candele; la volatilità realizzata come punti orari degli ultimi 16 giorni circa; il funding orario dei perpetual e il funding accumulato in un periodo; i prezzi attuali degli indici; e i prezzi di consegna (settlement) giornalieri di un indice.

Unità e orari: ogni timestamp, in ingresso e in uscita, è in millisecondi Unix (UTC); l'AI calcola gli intervalli dall'ora attuale (gli ultimi 7 giorni sono adesso meno 604800000). I prezzi delle opzioni inverse su BTC ed ETH sono quotati nella moneta di base, non in USD: per avere dollari l'AI moltiplica per underlying_price o per il prezzo dell'indice. I prezzi di future e perpetual sono in USD. L'open interest dei future inversi è in USD, quello delle opzioni in contratti della moneta di base. mark_iv è in percentuale. funding_8h e interest_8h sono frazioni su 8 ore (0.0001 = 0,01%).

Paginazione: lo storico DVOL restituisce un valore continuation quando esistono dati più vecchi, e l'AI richiama con end_timestamp impostato su quel valore. Gli scambi riportano has_more; i prezzi di consegna riportano records_total e si sfogliano con offset.

Sola lettura: ogni strumento legge soltanto dati di mercato pubblici, quindi non c'è nulla da confermare e nessuno strumento è disattivato all'installazione. I metodi privati (trading, posizioni, wallet) non fanno parte del connettore.

Limiti: le chiamate pubbliche sono limitate per IP con un sistema a crediti, e una raffica di chiamate può rispondere too_many_requests (codice 10028). L'AI evita di ciclare su centinaia di strumenti: una sola chiamata a deribit_get_book_summary_by_currency li copre tutti. La profondità dell'order book resta bassa (ad esempio 20) a meno che serva il book completo; gli scambi arrivano fino a 1000 per chiamata.

Errori comuni: gli errori tornano come oggetto JSON-RPC error, ad esempio per un nome di strumento sconosciuto o un parametro obbligatorio mancante. Un'opzione scaduta non compare più tra gli strumenti attivi; deribit_get_instruments con expired true elenca quelli scaduti di recente.

Il connettore non inserisce né annulla ordini, non legge conti, posizioni o wallet e non sposta fondi.

Step 2 — Installa l'adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Step 3 — Aggiungi il connettore in Gemini

L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostra YOUR_SERVER_ID.

Gemini CLI legge i server MCP da ~/.gemini/settings.json (su Windows %USERPROFILE%\.gemini\settings.json). Aggiungi:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una chiave API MCP in AnythingMCP da MCP Servers → il tuo server → API keys e incollala al posto di YOUR_MCP_API_KEY.
2. Salva il file e riavvia gemini.
3. Esegui /mcp in Gemini CLI (oppure gemini mcp list dal terminale): anythingmcp dovrebbe risultare connesso.
4. Inizia a scrivere prompt: Gemini CLI ora può chiamare i tool di Deribit.

Tool disponibili

Esempi di prompt

• "Mostra l'open interest delle opzioni BTC per strike sulla prossima scadenza mensile e calcola il prezzo di max pain."
• "Dove si trova ora l'indice DVOL di BTC, e come si è mosso negli ultimi 30 giorni?"
• "Confronta la volatilità implicita di BTC (DVOL) con la volatilità realizzata delle ultime due settimane."
• "Qual è stato il funding rate di BTC-PERPETUAL negli ultimi 7 giorni, in totale e per giorno?"
• "Mostra il ticker di una put ETH vicina al prezzo con scadenza questo mese, con le greche e il prezzo in USD."

FAQ

Dove cerca i server MCP Gemini CLI? In ~/.gemini/settings.json per il tuo utente, oppure in .gemini/settings.json dentro un progetto. gemini mcp list mostra ogni server e se si connette.

Prossimi passi

• Landing del connettore
• Collegare a Claude
• Collegare a ChatGPT
• Collegare a Cursor
• Collegare a Meta Muse
• Collegare a Microsoft Copilot