Frankfurter

Working · 2.8 s

io.github.lineofflight/frankfurterv0.5.2

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

Finance & Payments

Source Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://mcp.frankfurter.dev/

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

convert Read-only

Convert an amount from one currency to another. Returns {amount, currency} rounded to the target's minor units. Upstream rounds rates per direction; for low-value sources, flip via `get_rates` for more precision. Pass `provider` to use one institution's published rate, e.g. UST for a U.S. Treasury reporting rate.

tostring, required

ISO 4217 target currency.

fromstring, required

ISO 4217 source currency.

amountnumber, required

Amount in the source currency. Normalize localized input first: '100,50' -> 100.5; German '1.000,50' -> 1000.5; English '1,000.50' -> 1000.5.

datestring

Date YYYY-MM-DD for a past rate; omit for latest.

providerstring

Provider key, e.g. ECB for European Central Bank or UST for U.S. Treasury reporting rates. Serves that institution's published rates instead of the blend; a date inside a monthly or quarterly provider's period returns the rate in force. Keys at https://frankfurter.dev/providers/.

Tools (4)

convert

read-only

Argument	Type	Description
to*	string	ISO 4217 target currency.
date	string	Date YYYY-MM-DD for a past rate; omit for latest.
from*	string	ISO 4217 source currency.
amount*	number	Amount in the source currency. Normalize localized input first: '100,50' -> 100.5; German '1.000,50' -> 1000.5; English '1,000.50' -> 1000.5.
provider	string	Provider key, e.g. ECB for European Central Bank or UST for U.S. Treasury reporting rates. Serves that institution's published rates instead of the blend; a date inside a monthly or quarterly provider's period returns the rate in force. Keys at https://frankfurter.dev/providers/.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "amount",
    "from",
    "to"
  ],
  "properties": {
    "to": {
      "type": "string",
      "maxLength": 3,
      "minLength": 3,
      "description": "ISO 4217 target currency."
    },
    "date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Date YYYY-MM-DD for a past rate; omit for latest."
    },
    "from": {
      "type": "string",
      "maxLength": 3,
      "minLength": 3,
      "description": "ISO 4217 source currency."
    },
    "amount": {
      "type": "number",
      "description": "Amount in the source currency. Normalize localized input first: '100,50' -> 100.5; German '1.000,50' -> 1000.5; English '1,000.50' -> 1000.5."
    },
    "provider": {
      "type": "string",
      "maxLength": 8,
      "minLength": 2,
      "description": "Provider key, e.g. ECB for European Central Bank or UST for U.S. Treasury reporting rates. Serves that institution's published rates instead of the blend; a date inside a monthly or quarterly provider's period returns the rate in force. Keys at https://frankfurter.dev/providers/."
    }
  },
  "additionalProperties": false
}

get_rates

Latest or a single day's exchange rates. The raw-rate companion to `convert`. With `provider`, published rates from one or more institutions: on its own base the digits are as published, with the date they took effect.

read-only

Argument	Type	Description
base	string	ISO 4217 base currency. Default EUR.
date	string	Single day YYYY-MM-DD. Omit for the latest rates.
quotes	array	ISO 4217 quote codes to return; omit for all.
provider	array	Provider key or keys, e.g. ECB or ['ECB', 'HMRC']. Serves published rates instead of the blend; a date inside a monthly or quarterly provider's period returns the rate in force. Keys at https://frankfurter.dev/providers/.
providers	array	Alias for `provider` accepting multiple provider keys.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "base": {
      "type": "string",
      "maxLength": 3,
      "minLength": 3,
      "description": "ISO 4217 base currency. Default EUR."
    },
    "date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Single day YYYY-MM-DD. Omit for the latest rates."
    },
    "quotes": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 3,
        "minLength": 3
      },
      "description": "ISO 4217 quote codes to return; omit for all."
    },
    "provider": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 8,
        "minLength": 2
      },
      "description": "Provider key or keys, e.g. ECB or ['ECB', 'HMRC']. Serves published rates instead of the blend; a date inside a monthly or quarterly provider's period returns the rate in force. Keys at https://frankfurter.dev/providers/."
    },
    "providers": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 8,
        "minLength": 2
      },
      "description": "Alias for `provider` accepting multiple provider keys."
    }
  },
  "additionalProperties": false
}

list_currencies

List all supported ISO 4217 currency codes and their full names (e.g. { 'USD': 'United States Dollar' }).

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

list_providers

List the institutions whose rates Frankfurter relays, with key, rate type, frequency (daily, monthly or quarterly) and coverage dates. Use a key as `provider` in `convert` or `get_rates` for that institution's published rates instead of the blend.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}