MCP-Server

exchange-rates

io.github.theluckystrike/exchange-rates
Finanzen & Investieren Öffentlich und erreichbar MCP 2026-07-28

Was dieses MCP kann

Converts currencies and retrieves current, historical, and time-series ECB reference rates.

cache_status
Rate cache status
Report the ECB rate cache here: which dates are held, how old they are and when they refresh. Reads only. Check it before trusting a rate after time offline; a cache that no longer parses is quarantined and named.
Nur Lesen Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
convert
Convert an amount
Call this tool to convert an amount between any two ECB-quoted currencies, today or on a past date. Returns the converted amount, the cross rate to 6 decimals, the rounding applied and the rate date used.
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['amount', 'from'], 'properties': {'to': {'type': 'string', 'pattern': '^[A-Za-z]{3}$', 'description': "Currency to convert into; defaults to the shared business profile's default_currency, so you are never asked what currency you invoice in. The result is rounded once, at the end, to this currency's own ISO 4217 minor units, so JPY comes back whole and BHD to three places"}, 'date': {'type': 'string', 'maxLength': 10, 'description': 'ISO date YYYY-MM-DD. Omit for the latest published rate. A weekend or TARGET holiday falls back to the last rate published on or before it, and the answer says so. A date older than the free 90-day window is shortened to the oldest free day, not refused, and the answer names the date it really used'}, 'from': {'type': 'string', 'pattern': '^[A-Za-z]{3}$', 'description': 'Currency the amount is in. Cross rates go through the euro, the only pair the ECB publishes'}, 'amount': {'type': 'number', 'description': 'Amount in major units of the from currency, e.g. 100 or 12.34'}}, 'additionalProperties': False}
convert_many
Convert one amount into several currencies
Convert one amount into many currencies off the SAME ECB rate date, each rounded to its own minor units. For several lines at once (mixed-currency invoice lines), call it once per line: every line then shares one rate date. Unknown targets are listed, never failed.
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['amount', 'from', 'to'], 'properties': {'to': {'type': 'array', 'items': {'type': 'string', 'pattern': '^[A-Za-z]{3}$'}, 'maxItems': 60, 'minItems': 1, 'description': 'Target currencies'}, 'from': {'type': 'string', 'pattern': '^[A-Za-z]{3}$'}, 'amount': {'type': 'number'}}, 'additionalProperties': False}
currencies_list
Currencies the ECB quotes
Every currency in the ECB daily set with its rate against the euro and its decimal places. This is the whole domain: a code not on this list cannot be converted, quoted or historised here.
Nur Lesen Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
fx_rates_for
FX rates in the shape expense-tracker wants
Call this tool when a rebill or an invoice spans more than one currency, instead of asking the user for rates. Returns the fx_rates object expense_to_invoice takes, plus the rate date to write on the invoice.
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['currencies'], 'properties': {'target': {'type': 'string', 'pattern': '^[A-Za-z]{3}$', 'description': "The currency the invoice will be issued in; defaults to the shared business profile's default_currency. Pass it on as target_currency alongside the fx_rates object"}, 'currencies': {'type': 'array', 'items': {'type': 'string', 'pattern': '^[A-Za-z]{3}$'}, 'maxItems': 60, 'minItems': 1, 'description': 'The other currencies present, e.g. ["EUR", "GBP"]. Direction: each returned rate means 1 unit of that key = X units of the target, so {"EUR": 1.08} is 1 EUR = 1.08 of the target. The target needs no rate of its own'}}, 'additionalProperties': False}
license_activate
Activate license
Turn Pro on for this connection with key, an MCPL1.<payload>.<signature> issued at checkout for this server or the bundle. Data under your token stays; a wrong or expired key changes nothing. license_status confirms it.
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['key'], 'properties': {'key': {'type': 'string', 'description': 'License key from checkout, MCPL1.<payload>.<signature>'}}, 'additionalProperties': False}
license_status
License status
Report this endpoint's licence state for your token as JSON: the product, the tier free or pro, why it is not Pro, and the checkout URL. Call it to explain a free-tier refusal. No arguments, nothing changes.
Nur Lesen Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
rate_history
Rate history for a pair
Call this tool for the ECB rate of one currency pair across a window. Returns one row per published day plus the min, max, average and the change. A window wider than the free 90 days is shortened, not refused.
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['from', 'to'], 'properties': {'to': {'type': 'string', 'pattern': '^[A-Za-z]{3}$', 'description': 'Quote currency of the pair. Each row is 1 from = X to'}, 'days': {'type': 'integer', 'maximum': 20000, 'minimum': 1, 'description': 'Trailing window in calendar days, default 30. Only TARGET business days carry a rate, so 30 days holds about 21 rows. Free reads up to 90 days back; Pro reads the whole series back to 1999-01-04'}, 'from': {'type': 'string', 'pattern': '^[A-Za-z]{3}$', 'description': 'Base currency of the pair'}, 'to_date': {'type': 'string', 'maxLength': 10, 'description': 'ISO date, inclusive, default today'}, 'max_rows': {'type': 'integer', 'maximum': 2000, 'minimum': 1, 'description': 'Cap the table, default 200. min/max/avg still cover the whole window'}, 'from_date': {'type': 'string', 'maxLength': 10, 'description': 'ISO date, inclusive. Overrides days. Free is limited to the last 90 days'}}, 'additionalProperties': False}
rate_on
Rate on a given date
Call this tool for the ECB rate of one pair on one date. Returns both directions and the rate date, so a reciprocal is never reported as the published figure. A date beyond the free window is shortened, never refused.
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['from', 'to', 'date'], 'properties': {'to': {'type': 'string', 'pattern': '^[A-Za-z]{3}$', 'description': 'Quote currency. The rate returned is 1 from = X to'}, 'date': {'type': 'string', 'maxLength': 10, 'description': 'ISO date YYYY-MM-DD. If the ECB published nothing that day - every weekend, 1 January, Good Friday, Easter Monday, 1 May, 25 and 26 December - the last rate published on or before it is returned and the answer names that date. Free covers the last 90 days: an older date is shortened to the oldest free day rather than refused, and rate_date says which day the numbers are really from. Pro covers every date back to 1999-01-04'}, 'from': {'type': 'string', 'pattern': '^[A-Za-z]{3}$', 'description': 'Base currency. The ECB quotes every currency per 1 euro, so "the ECB rate for USD" is from EUR to USD, not the other way round; invert only if the user asked for the inverse'}}, 'additionalProperties': False}
rates_latest
Latest ECB reference rates
Call this tool for the latest ECB daily reference rates against any base: 1.0812 for USD means 1 base = 1.0812 USD. Crosses go through the euro. Returns the ECB rate date and the cache age.
Nur Lesen Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'base': {'type': 'string', 'pattern': '^[A-Za-z]{3}$', 'description': "Base currency; defaults to the shared business profile's default_currency, else EUR. A rate of 1.0812 for USD means 1 base = 1.0812 USD. Cross rates go through the euro, the only pair the ECB publishes"}, 'quotes': {'type': 'array', 'items': {'type': 'string', 'pattern': '^[A-Za-z]{3}$'}, 'maxItems': 200, 'description': 'Only these currencies, at most 200. Omit for all of them'}}, 'additionalProperties': False}
Hinzugefügt
license_activate
24. September 2026 02:40
Hinzugefügt
license_status
24. September 2026 02:40
Hinzugefügt
cache_status
24. September 2026 02:40
Hinzugefügt
currencies_list
24. September 2026 02:40
Hinzugefügt
rate_on
24. September 2026 02:40
Hinzugefügt
rate_history
24. September 2026 02:40
Hinzugefügt
fx_rates_for
24. September 2026 02:40
Hinzugefügt
convert_many
24. September 2026 02:40
Hinzugefügt
convert
24. September 2026 02:40
Hinzugefügt
rates_latest
24. September 2026 02:40