English Français العربية

Frankfurter

Registre officiel Autres

Convert currencies and fetch blended FX rates from 50+ institutional sources.

Code source Site web Documentation

Que pouvez-vous faire avec Frankfurter ?

  • convert — the primary tool. Convert an amount between two currencies;
  • get_rates — blended reference rates for the latest day or a single
  • list_currencies — supported ISO 4217 codes and names as { code: name }.
  • list_providers — the institutions relayed, with key, rate type,

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http frankfurter 'https://mcp.frankfurter.dev/'
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "frankfurter": {
            "type": "http",
            "url": "https://mcp.frankfurter.dev/"
        }
    }
}

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. frankfurter-mcp
  2. Tools
  3. Run
  4. Configuration
  5. Development
  6. License

frankfurter-mcp

Official Model Context Protocol server for the Frankfurter exchange-rate API. A thin, stateless proxy over Frankfurter's v2 blended multi-source reference rates.

Tools

  • convert — the primary tool. Convert an amount between two currencies; returns a money object { amount, currency } rounded to the target's minor units. Pass date for a historical rate, provider for one institution's published rate (e.g. UST, the U.S. Treasury's quarterly reporting rate).
  • get_rates — blended reference rates for the latest day or a single date. Optional base, quotes and provider (or providers to compare multiple institutions). The raw-rate companion to convert; with provider and the provider's own base, the digits are as published, with the date they took effect.
  • list_currencies — supported ISO 4217 codes and names as { code: name }.
  • list_providers — the institutions relayed, with key, rate type, frequency and coverage dates, to pick a provider.

For time series, historical ranges, or bulk queries, use the REST API at https://api.frankfurter.dev/v2 directly.

Rates are daily reference rates, not real-time trading rates. Not financial advice.

Run

npm install
npm run build
npm start            # listens on :3000, POST /

Docker:

docker build -t frankfurter-mcp . && docker run -p 3000:3000 frankfurter-mcp
docker run -p 3000:3000 ghcr.io/lineofflight/frankfurter-mcp:latest

The prebuilt ghcr.io/lineofflight/frankfurter-mcp:latest image is published on each release; building from source also works.

Point any MCP client at http://<host>:3000/ (Streamable HTTP). The hosted server is at https://mcp.frankfurter.dev/.

Configuration

  • PORT — HTTP port (default 3000).
  • FRANKFURTER_API_URL — upstream API base (default https://api.frankfurter.dev). Set this to a self-hosted Frankfurter instance if desired. The value must be a host root: any path prefix in it is discarded (e.g. https://example.com/api resolves to https://example.com/v2/rates), so a self-hosted instance must be reachable at the host root.

Development

npm test       # vitest
npm run lint   # biome

License

MIT

Questions fréquentes

Qu'est-ce que Frankfurter ?

Convert currencies and fetch blended FX rates from 50+ institutional sources.

Comment installer Frankfurter ?

Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport http frankfurter 'https://mcp.frankfurter.dev/'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour Frankfurter ?

Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.

Frankfurter est-il open source ?

Son code est public sur GitHub, mais le dépôt ne déclare pas de licence standard.

Qui maintient Frankfurter ?

Il est publié par lineofflight. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.