Domande o problemi? Scrivi nelle GitHub Discussions.

Converti valute e consulta tassi di cambio attuali o storici direttamente dal tuo assistente AI, tramite il server Model Context Protocol ufficiale. I dati giornalieri risalgono al 1948.

Aggiungi https://mcp.frankfurter.dev/ come server HTTP remoto. Non servono chiavi API né registrazione.

ChatGPT

  1. Apri Impostazioni e poi App (o Connettori).
  2. In alto a destra, fai clic su Impostazioni avanzate e attiva la Modalità sviluppatore per poter creare app personalizzate.
  3. Torna al menu App e fai clic su Crea app (o Crea connettore).
  4. Inserisci l'URL dell'endpoint: https://mcp.frankfurter.dev/.
  5. In Autenticazione, scegli Nessuna.

Claude

In Claude Code:

claude mcp add frankfurter https://mcp.frankfurter.dev/

In Claude Desktop o Claude.ai:

  1. Apri Impostazioni e poi Connettori.
  2. Fai clic su Aggiungi connettore personalizzato.
  3. Inserisci l'URL dell'endpoint: https://mcp.frankfurter.dev/.
  4. Fai clic su Aggiungi per finire. Una volta connesso, attiva il connettore nella chat.

Altri client

Aggiungilo alla tua configurazione MCP (Cursor, Windsurf, VS Code, ecc.):

{
  "mcpServers": {
    "frankfurter": {
      "url": "https://mcp.frankfurter.dev/"
    }
  }
}

Tool

Una volta connesso, il tuo assistente AI ha a disposizione questi tool:

convert
Converte un importo tra due valute. Restituisce l'importo convertito e il tasso.
Parametri:
  • amount (numero, obbligatorio): il valore totale da convertire.
  • from (stringa, obbligatorio): codice della valuta o dell'asset di origine (es. USD, XAU o BTC).
  • to (stringa, obbligatorio): codice della valuta o dell'asset di destinazione (es. EUR).
  • date (stringa, facoltativo): una data specifica YYYY-MM-DD per una conversione storica.
  • provider (stringa, facoltativo): chiave di una fonte (es. ECB o UST), per usare il tasso pubblicato da una singola istituzione invece di quello combinato. Per le fonti settimanali, mensili o trimestrali, una data all'interno del periodo restituisce il tasso in vigore.
get_rates
Restituisce i tassi di cambio di riferimento.
Parametri:
  • date (stringa, facoltativo): data del tasso YYYY-MM-DD (default: la più recente).
  • base (stringa, facoltativo): codice della valuta o dell'asset di base (default: EUR).
  • quotes (stringa o array, facoltativo): filtra i risultati per codici di valute o asset.
  • provider / providers (stringa o array, facoltativo): una o più chiavi di fonti. Sulla valuta di base della fonte, le cifre sono quelle pubblicate, con la data in cui sono entrate in vigore.
list_currencies
Elenca tutti i codici supportati di valute, metalli preziosi e cripto-asset con i relativi nomi.
list_providers
Elenca le istituzioni disponibili, con chiave, tipo di tasso, frequenza e date di copertura, per scegliere un provider. Le istituzioni che pubblicano più dataset elencano anche questi. Una chiave di dataset come NBP.B in provider seleziona solo quello.

Se hai bisogno di una serie temporale, un intervallo storico o dati in blocco, usa l'API REST.