Summary
Wraps the Frankfurter API to give Claude access to blended foreign exchange rates aggregated from 50+ institutional sources. Exposes four tools: get_rates pulls daily reference rates (latest, historical, or time series), convert handles currency conversions with a specific amount, list_currencies returns supported ISO 4217 codes, and list_providers shows available data sources. You can query the blended rate or pick a single provider. Rates are end-of-day reference rates, not live trading data. Available as a hosted service at mcp.frankfurter.dev or self-hostable via Docker. Useful when you need reliable FX data for financial calculations, reporting, or historical analysis without managing API keys or rate limits.
Fastest browser for AI agents to run web automation tasks, always free.
Download Free life-time →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →
Free an open-source skills that make AI coding agents easier to understand, verify, and control.
Download for free →
Connect your Claude agent to live crypto prices and trading routes via 1inch
Get the MCP →
Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →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. Passdatefor a historical rate,providerfor 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 singledate. Optionalbase,quotesandprovider. The raw-rate companion toconvert; withproviderand 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 aprovider.
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 (default3000).FRANKFURTER_API_URL— upstream API base (defaulthttps://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/apiresolves tohttps://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
Featured
Fastest browser for AI agents to run web automation tasks, always free.
Download Free life-time →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Free an open-source skills that make AI coding agents easier to understand, verify, and control.
Download for free →Connect your Claude agent to live crypto prices and trading routes via 1inch
Get the MCP →Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →
