Frankfurter Forex MCP
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Frankfurter Forex MCP Convert 250 Euros to US Dollars"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Frankfurter Forex MCP
MCP server in Python for currency rates, conversion, and exchange-rate history using the Frankfurter API.
Features
base_quote: latest rates from a base currency to one or many targetsconvert_currency: converts an amount between two currenciesexchange_history: returns the time series for a currency pair in a date rangeStructured error payloads with
error_code,tool, andtrace_idRetry with exponential backoff for transient upstream failures
Related MCP server: FrankfurterMCP
Tech stack
Python 3.11+
MCP Python SDK (
mcp)httpxasync clientPydantic v2
pytest,pytest-asyncio,ruff
Project structure
src/frankfurter_forex_mcp/
client/frankfurter.py
models/schemas.py
tools/
base_quote.py
convert_currency.py
exchange_history.py
server.py
tests/Setup
Install dependencies:
uv sync --all-extrasCopy environment file:
cp .env.example .envRun MCP server (stdio)
uv run python -m frankfurter_forex_mcp.serverUse with MCP Inspector on localhost
The easiest way to expose this server in the local Inspector is using:
uv run mcp dev src/frankfurter_forex_mcp/server.pyThis command starts the local Inspector bridge and shows a localhost URL in the terminal.
For a manual Inspector stdio connection flow, see .docs/mcp-inspector-guide.md.
Advanced MCP practices implemented
Strict request validation with Pydantic before external calls
Strict external payload validation before response serialization
Stable JSON error contracts for machine clients
stdio-safe runtime behavior (no stdout logging side effects)CI pipeline for linting, testing, and package smoke checks
Run quality checks
uv run ruff check .
uv run pytestCI
GitHub Actions workflow is available at .github/workflows/ci.yaml.
Available Tools
3 toolsbase_quoteC
Get latest exchange rates from one base currency to multiple target currencies.
Inputs: base (required), targets (required).
convert_currencyC
Convert a monetary amount from one currency to another.
Inputs: amount (required), from_currency (required), to_currency (required).
exchange_historyC
Get an exchange-rate time series for a currency pair and date interval.
Inputs: start (required), end (required), from_currency (required), to_currency (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
Each tool has a clearly distinct purpose with no overlap: base_quote retrieves latest rates from one base to multiple targets, convert_currency handles specific amount conversions, and exchange_history provides historical time series data. An agent can easily differentiate these functions without confusion.
The naming follows a consistent pattern with two tools using snake_case (base_quote, exchange_history) and one using a verb_noun style (convert_currency), which is a minor deviation. All names are descriptive and readable, but the mix of conventions slightly reduces consistency.
With 3 tools, this is well-scoped for a forex server, covering core operations: real-time rates, currency conversion, and historical data. Each tool earns its place without bloat or thinness, making it appropriate for the domain.
The toolset covers key forex functionalities—real-time rates, conversions, and historical data—with no major gaps. Minor gaps might include advanced features like currency lists or metadata, but agents can work effectively with the provided tools for common workflows.
Related MCP Connectors
A MCP server for the Frankfurter API for currency exchange rates.
Unofficial Frankfurter MCP — wraps Frankfurter API (api.frankfurter.dev)
Unofficial Exchange MCP — wraps the Frankfurter currency exchange API (free, no auth)
Related MCP Servers
- FlicenseCqualityDmaintenanceAn MCP server providing real-time currency conversion and exchange rate data through the Frankfurter API, enabling users to convert currencies, fetch latest or historical rates, and list available currencies.437-
- AlicenseBqualityBmaintenanceA MCP server for the Frankfurter API for currency exchange rates.66MIT
- -licenseNot gradedqualityNot gradedmaintenanceMCP server that provides real exchange-rate data from the European Central Bank, including latest rates, currency conversion, historical rates, and time series.-
- FlicenseNot gradedqualityDmaintenanceAn MCP server that integrates ExchangeRate-API and Open-Meteo to provide currency conversion and weather tools, enabling natural language queries for exchange rates, weather, and geocoding.-