Come collegare FRED a Gemini via MCP

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

FRED + Gemini

Dati economici da FRED (Federal Reserve Bank of St. Louis): cerca circa 800.000 serie di USA e altri paesi come PIL, inflazione, disoccupazione, tassi e cambi, leggi i valori con trasformazioni, consulta pubblicazioni e calendario e vedi le revisioni. Sola lettura, chiave API gratuita.

Prerequisiti

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

FRED_API_KEY

Step 1 — Ottieni le credenziali

La configurazione richiede circa 2 minuti ed è gratuita. Ti serve un account FRED gratuito.

1. Accedi o crea un account gratuito su https://fredaccount.stlouisfed.org.
2. Apri API Keys (https://fredaccount.stlouisfed.org/apikeys), richiedi una chiave e descrivi l'uso in una frase. La chiave è una stringa di 32 caratteri minuscoli e viene rilasciata subito.
3. Incollala in FRED_API_KEY. Viene inviata come parametro di query api_key.
4. Installa il connettore; la verifica legge la categoria radice con fred_get_category. Poi prova fred_get_observations con UNRATE e limit 1 per l'ultimo tasso di disoccupazione degli Stati Uniti.

Trovare una serie: fred_search_series cerca in titoli, unità, note e tag; order_by popularity mette per prime le serie principali, e search_type series_id confronta gli id anche con caratteri jolly come DGS*. Id noti: GDP, GDPC1 (PIL reale), UNRATE, PAYEMS (occupati non agricoli), CPIAUCSL, CPILFESL (inflazione di fondo), PCEPI, FEDFUNDS, DGS10, T10Y2Y, MORTGAGE30US, SP500, VIXCLS, DCOILWTICO, DEXUSEU (USD per EUR), M2SL. Puoi anche scorrere l'albero delle categorie dalla categoria radice 0, elencare le serie di una pubblicazione o combinare tag come gdp;germany con fred_list_tag_series.

Cosa legge: i valori di una serie, dal più recente (per impostazione predefinita gli ultimi 1000, oppure un periodo con observation_start e observation_end); i metadati di una serie (unità, frequenza, destagionalizzazione, note, ultimo aggiornamento) con categorie, pubblicazione e tag; le categorie e le loro serie; le pubblicazioni statistiche, le loro serie e date di uscita, e il calendario di tutte le pubblicazioni, comprese le date future; le fonti dei dati e le loro pubblicazioni; i tag; le serie aggiornate di recente; e le date di vintage in cui una serie è stata pubblicata o rivista. I dati provengono da oltre 100 fonti come BEA, BLS, Federal Reserve Board, Census Bureau, OCSE, FMI ed Eurostat.

Trasformazioni: units trasforma i livelli in variazione, variazione percentuale, variazione percentuale sull'anno precedente (pc1), tassi annui composti o logaritmo naturale. frequency con aggregation_method (media, somma o fine periodo) aggrega a una frequenza più bassa, ad esempio da tassi giornalieri a medie mensili; non può superare la frequenza propria della serie.

Revisioni: fred_list_vintage_dates elenca quando una serie è stata pubblicata o rivista (ALFRED). fred_get_observations con realtime_start e realtime_end impostati sulla stessa data di vintage mostra i dati come erano noti quel giorno, ad esempio la prima stima di un trimestre del PIL.

Formati dei dati: i valori sono stringhe nell'unità della serie, quindi l'AI controlla unità e destagionalizzazione prima di confrontare due serie. Un valore "." significa nessuna osservazione per quella data, ad esempio un giorno festivo. Le date sono YYYY-MM-DD e indicano l'inizio del periodo (2026-04-01 per il secondo trimestre 2026). Le serie mensili e trimestrali escono con un ritardo, quindi l'AI cita la data dell'ultima osservazione, non quella di oggi. La finestra di fred_list_series_updates è YYYYMMDDHhmm nell'ora centrale USA. L'AI cita FRED e la fonte originale dalle note della serie; alcune serie sono protette da copyright della fonte, e le note lo indicano.

Sola lettura: ogni strumento legge soltanto, quindi non c'è nulla da confermare e nessuno strumento è disattivato all'installazione.

Limiti: fino a 120 richieste al minuto per chiave. Gli elenchi si sfogliano con limit e offset.

Errori comuni: FRED risponde 400 con un error_message che nomina il problema: "api_key is not registered" per una chiave errata o mancante, "The series does not exist" per un id sconosciuto, oppure un parametro non valido, come una frequenza più alta di quella della serie. 429 significa limite raggiunto: attendi un minuto.

Il connettore non copre le mappe e le aree regionali di GeoFRED, il download massivo di FRED v2 né i gruppi di serie.

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 FRED.

Tool disponibili

Esempi di prompt

• "Qual è l'ultimo tasso di disoccupazione degli Stati Uniti in FRED, e a quale mese si riferisce?"
• "Mostrami l'inflazione CPI degli Stati Uniti anno su anno negli ultimi 24 mesi."
• "Confronta i rendimenti dei Treasury a 10 e a 2 anni nell'ultimo anno come medie mensili."
• "Quando è prevista la prossima pubblicazione dell'Employment Situation?"
• "Qual era il primo valore pubblicato del PIL reale USA per il primo trimestre 2026, e come è stato rivisto da allora?"

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