Collegare Alpha Vantage MCP a Gemini CLI

💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → Alpha Vantage, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente git clone, niente server locale.

Alpha Vantage + Gemini

Dati di mercato da Alpha Vantage: quotazioni azionarie e storico giornaliero o intraday delle borse di tutto il mondo, fondamentali e utili delle aziende, dividendi, partecipazioni di insider e istituzionali, profili ETF, opzioni, indici, forex, cripto, materie prime, indicatori economici USA, indicatori tecnici e notizie con sentiment. Solo lettura; una API key gratuita consente 25 richieste al giorno.

Prerequisiti

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

ALPHA_VANTAGE_API_KEY

Step 1 — Ottieni le credenziali

La configurazione richiede circa un minuto. Ti serve una API key di Alpha Vantage; per quella gratuita basta un indirizzo e-mail.

1. Richiedi una chiave gratuita su https://www.alphavantage.co/support/#api-key.
2. Inseriscila in ALPHA_VANTAGE_API_KEY. Viene inviata come parametro di query apikey.
3. Installa il connettore ed esegui alpha_vantage_get_market_status: mostra quali mercati azionari, forex e cripto sono aperti in questo momento e conferma la chiave.

Piani: la chiave gratuita consente 25 richieste al giorno. I piani premium (https://www.alphavantage.co/premium/) portano il limite a 75 o più richieste al minuto e sbloccano i dati USA in tempo reale, lo storico intraday, le serie giornaliere rettificate, le opzioni e le quotazioni in blocco. Con 25 chiamate al giorno l'AI sceglie il tool che risponde alla domanda invece di provarne diversi.

Simboli: i simboli USA sono semplici (IBM); le altre borse hanno un suffisso, come TSCO.LON, SAP.DEX, RELIANCE.BSE o SHOP.TRT. Se il simbolo esatto non è noto, l'AI lo cerca prima con alpha_vantage_search_symbols.

Cosa legge:

• Prezzi: l'ultima quotazione di un'azione o di un ETF, quotazioni in tempo reale per fino a 100 simboli USA alla volta (premium), storico giornaliero, settimanale e mensile su oltre 20 anni, grezzo o rettificato per split e dividendi, e barre intraday delle azioni USA da 1 a 60 minuti. Lo stato dei mercati nel mondo e i 20 titoli USA con maggior rialzo, maggior ribasso e più scambiati della giornata.
• Analisi aziendale: la panoramica con settore, multipli di valutazione, margini e prezzo obiettivo degli analisti; conti economici, stati patrimoniali e rendiconti finanziari annuali e trimestrali; utile per azione con sorprese; stime degli analisti su EPS e ricavi; azioni in circolazione; dividendi e split; operazioni degli insider; partecipazioni istituzionali; trascrizioni delle earnings call dal 2010Q1.
• Fondi e indici: profili ETF con posizioni e ripartizione per settore, e lo storico di oltre 200 indici di mercato come SPX, NDX o VIX.
• Opzioni (premium): la catena di opzioni USA in tempo reale con greche e volatilità implicita, o la catena di un giorno di borsa passato dal 2008.
• Notizie: articoli su ticker o temi con sentiment complessivo e per ticker.
• Valute e cripto: il tasso di cambio di qualsiasi coppia, tradizionale o cripto, e lo storico giornaliero, settimanale o mensile (intraday con premium).
• Macro: PIL reale USA, rendimenti dei titoli del Tesoro, tasso dei federal funds, CPI, inflazione, disoccupazione, occupati non agricoli, vendite al dettaglio e ordini di beni durevoli; materie prime come WTI, Brent, gas naturale, rame, grano e caffè; prezzo spot e storico di oro e argento.
• Oltre 50 indicatori tecnici, come SMA, EMA, RSI, MACD, bande di Bollinger, ADX o ATR.

Formati dei dati: i numeri arrivano come stringhe, spesso con chiavi numerate come "05. price". Le serie storiche sono oggetti con data (YYYY-MM-DD) o timestamp come chiave, dalle più recenti; i timestamp intraday sono in ora della costa orientale USA. I fondamentali sono nella valuta di bilancio (reportedCurrency) e in unità intere, e "None" significa non dichiarato. I dati giornalieri sono di fine giornata, salvo un entitlement premium. Il sentiment va da -1 (ribassista) a 1 (rialzista).

Volume dei dati, nessuna paginazione: ogni chiamata restituisce la risposta intera. outputsize compact (qui il default) restituisce gli ultimi 100 punti; full può restituire 20 anni. Gli indicatori tecnici coprono sempre tutto lo storico dell'intervallo, quindi per periodi lunghi l'AI usa dati settimanali o mensili. Per le opzioni imposta un expiration per tenere piccola la catena.

Solo lettura: ogni tool legge soltanto, quindi non c'è nulla da confermare e nessun tool è disattivato all'installazione.

Errori comuni: Alpha Vantage risponde HTTP 200 anche in caso di errore; il connettore trasforma queste risposte in chiamate fallite. Un messaggio sul limite di frequenza significa che la quota giornaliera (25 con la chiave gratuita) o quella al minuto è esaurita, o che le chiamate sono arrivate più veloci di circa una al secondo: aspetta o passa a un piano superiore. Un messaggio premium significa che la funzione o l'opzione richiede un piano a pagamento; le quotazioni in blocco con chiave gratuita restituiscono dati di esempio e falliscono. "Invalid API call" indica un simbolo o un parametro errato. 401 significa che la chiave è stata rifiutata.

Il connettore non usa gli endpoint solo CSV (listing status, calendario degli utili, calendario delle IPO) né gli endpoint di analisi avanzata. Alpha Vantage gestisce anche un server MCP ufficiale su https://mcp.alphavantage.co.

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 Alpha Vantage.

Tool disponibili

Esempi di prompt

• "A quanto quota Apple in questo momento e quanto si è mossa oggi?"
• "Confronta ricavi, reddito operativo e free cash flow di Microsoft e Alphabet negli ultimi quattro esercizi."
• "Mostrami le chiusure giornaliere di SAP su XETRA degli ultimi 100 giorni di borsa."
• "Qual è il sentiment delle ultime notizie su NVIDIA, e quali articoli sono più rialzisti?"
• "Come sono cambiati il rendimento del Treasury USA a 10 anni e l'inflazione CPI negli ultimi due anni?"

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