Questions or problems? Post in GitHub Discussions.

Convert currencies and look up current or historical exchange rates straight from your AI assistant, through the official Model Context Protocol server. Data goes back to 1948.

Add https://mcp.frankfurter.dev/ as a remote HTTP server. No API key or registration required.

Installation

  1. Open Settings, then Apps (or Connectors).
  2. In the upper right, click Advanced settings and enable Developer mode to allow custom apps.
  3. Return to the Apps submenu, click Create app (or Create connector).
  4. Enter the endpoint URL: https://mcp.frankfurter.dev/.
  5. Under authentication, choose None.

In Claude Code:

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

In Claude Desktop or Claude.ai:

  1. Open Settings, then Connectors.
  2. Click Add custom connector.
  3. Enter the endpoint URL: https://mcp.frankfurter.dev/.
  4. Click Add to finish. Once connected, toggle the connector on in your chat interface.

Add to your MCP config (Cursor, Windsurf, VS Code, etc.):

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

Tools

Once connected, your assistant can use these tools:

convert
Convert an amount between two currencies. Returns the converted amount and the rate.
Parameters:
  • amount (number, required): The amount to convert.
  • from (string, required): Three-letter base ISO currency code (e.g. USD).
  • to (string, required): Three-letter target ISO currency code (e.g. EUR).
  • date (string, optional): A specific date YYYY-MM-DD for historical conversion.
  • provider (string, optional): A provider key, for one institution's published rate instead of the blend. UST is the U.S. Treasury's quarterly reporting rate; a date inside the quarter returns the rate in force.
get_rates
Look up reference exchange rates.
Parameters:
  • date (string, optional): Rate date YYYY-MM-DD (defaults to latest).
  • base (string, optional): Three-letter base currency (default: EUR).
  • quotes (string, optional): Filter results by comma-separated currency codes.
  • provider (string, optional): A provider key. On the provider's own base the digits are as published, with the date they took effect.
list_currencies
List all supported ISO 4217 currency codes and names.
list_providers
List the providers, with key, rate type, frequency and coverage dates, to pick a provider.

If you need a time series, a historical range, or bulk data, use the REST API.