FrankfurterMCP

FrankfurterMCP

MCP server acting as an interface to the Frankfurter API for currency exchange data.

5
Stars
10
Forks
20
Releases

Overview

Frankfurter MCP is an MCP server that exposes the Frankfurter API's currency exchange data to language models and MCP clients. It provides MCP tools to query supported currencies, latest exchange rates for a given base currency, conversions using the latest rates, and historical rates for a date or date range. To improve performance, the server caches responses with two strategies: an LRU cache for data that does not change across parameters (e.g., historical rates) and a TTL cache for faster-changing data (e.g., latest rates), with a default TTL of 15 minutes. Cache behavior and sizes are configurable via environment variables (LRU_CACHE_MAX_SIZE, TTL_CACHE_MAX_SIZE, TTL_CACHE_TTL_SECONDS). The server can run with stdio, SSE, or streamable HTTP transports; when using HTTP transports, endpoints are available at /sse (SSE) or /mcp (streamable HTTP). It supports configuration through FAST_MCP_HOST/PORT and FRANKFURTER_API_URL to point to the deployment. The server can be started via uv, installed from PyPI, or run in Docker. Available MCP tools include get_supported_currencies, get_latest_exchange_rates, convert_currency_latest, get_historical_exchange_rates, and convert_currency_specific_date.

Details

Owner
anirbanbasu
Language
Python
License
MIT License
Updated
2025-12-07

Features

get_supported_currencies

Get a list of currencies supported by the Frankfurter API.

get_latest_exchange_rates

Get latest exchange rates in specific currencies for a given base currency.

convert_currency_latest

Convert an amount from one currency to another using the latest exchange rates.

get_historical_exchange_rates

Get historical exchange rates for a specific date or date range in specific currencies for a given base currency.

convert_currency_specific_date

Convert an amount from one currency to another using the exchange rates for a specific date.

Audience

LLMsQuery currency data and perform conversions during reasoning via MCP endpoints.
MCP DevelopersIntegrate Frankfurter data into tools via MCP endpoints and transports.
MCP InspectorsConnect via MCP Inspector to discover, connect to, and test server tools.

Tags

FrankfurterMCPcurrencyexchange-rateslatest-rateshistorical-ratescachingLRUTTLserverSSEstreamable-httpstdioDockerPython