convert_currency_latest
Converts an amount from one currency to another using the latest exchange rates.
LABSCO SUMMARY
A date with no published rate returns the closest earlier one instead of failing — which a report wants and a reconciliation should know about.
Both historical tools substitute the rate from the nearest earlier date, so a weekend or a holiday still answers; that is convenient for restating figures and worth remembering when a number has to tie out to the exact day. The conversion tools take the amount itself, so the arithmetic never comes back to the model. One tool does no currency work at all: greet exists to demonstrate the server's middleware.
What it is
A currency-rate client over the Frankfurter API, which publishes exchange rates sourced from the European Central Bank. Six tools cover conversion and historical lookups, with results cached locally so repeated questions do not re-hit the API.
What you get
- The supported set up front: the three-letter currency codes the other tools accept (get_supported_currencies).
- Current rates, listed or converted: the latest rates for a base currency, optionally filtered to chosen symbols, and a direct conversion of an amount between two currencies (get_latest_exchange_rates, convert_currency_latest).
- The same moves against the past: rates for a specific date or across a start-to-end range, and an amount converted at a named date's rate (get_historical_exchange_rates, convert_currency_specific_date).
- A defined fallback instead of an error — when no rate exists for the date asked for, the rate from the closest earlier date is used, so a weekend or a public holiday still produces an answer.
- Caching split by whether the answer can change: historical lookups go into a least-recently-used cache, while latest rates use a time-to-live cache defaulting to 15 minutes, both adjustable.
Requirements
No account and no key — the Frankfurter API is open. Python 3.12 or newer, installed from PyPI or from a clone using uv. Stdio is the default transport; MCP_SERVER_TRANSPORT switches it to sse or streamable-http, in which case the bind host, port and CORS origins matter — the defaults are localhost and 127.0.0.1 for a reason. The HTTP client's timeout defaults to 5 seconds and accepts anything between 5 and 60. The host needs outbound network access.
Setup effort
One command — pip install frankfurtermcp
USE CASES
01
Quoting a price to a customer who pays in another currency
Check the currency is covered, then convert at the latest rate rather than doing the arithmetic in conversation.
02
Restating a past transaction at the rate that applied on the day
Convert at that date's rate; a date with no published rate falls back to the closest earlier one.
03
Plotting how a pair moved across a quarter
Pull the series over a start and end date, filtered to the currencies you care about.
04
Checking today's rates across several currencies at once
One call returns the base currency against every symbol you name.
6 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
convert_currency_specific_date
Convert an amount from one currency to another using the exchange rates for a specific date.
If there is no exchange rate available for the specific date, the rate for the closest available date before the specified date will be used.
get_historical_exchange_rates
Returns historical exchange rates for a specific date or date range.
If the exchange rates for a specified date is not available, the rates available for the closest date before the specified date will be provided. Either a specific date, a start date, or a date range must be provided. The symbols can be used to filter the results to specific currencies. If symbols are not provided, all supported currencies will be returned.
get_latest_exchange_rates
Returns the latest exchange rates for specific currencies.
The symbols can be used to filter the results to specific currencies. If symbols is not provided, all supported currencies will be returned.
get_supported_currencies
Returns a list of three-letter currency codes for the supported currencies.
greet
A simple greeting tool to demonstrate middleware functionality.
BEFORE YOU INSTALL
What to know first
Tools you get
6 tools when we connected. greet is a test tool, so 5 of the 6 handle currency.
Requires
uvx on PATH
CONTEXT COST
Moderate Standing cost
Rated by the size of the 6 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Server setup
TERMINAL
pip install frankfurtermcpMCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"frankfurtermcp": {
"command": "uvx",
"args": [
"frankfurtermcp"
]
}
}
}VS Code
VS CODE · JSON
{
"servers": {
"frankfurtermcp": {
"command": "uvx",
"args": [
"frankfurtermcp"
]
}
}
}MCP Inspector
MCP INSPECTOR · TERMINAL
git clone https://github.com/anirbanbasu/frankfurtermcp.git
cd frankfurtermcp
npx @modelcontextprotocol/inspector uv run frankfurtermcp
