Serveur MCP

currency-converter-ecb-rates-daily-keyless

io.github.theluckystrike/currency-converter-ecb-rates-daily-keyless
Finance et investissement Public et accessible MCP 2026-07-28

Ce que fait ce MCP

Converts currencies and provides current and historical European Central Bank reference rates, including rate histories and multi-currency calculations.

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.
Lecture seule Idempotent
Schéma d’entrée
{'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.
Schéma d’entrée
{'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.
Schéma d’entrée
{'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.
Lecture seule Idempotent
Schéma d’entrée
{'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.
Schéma d’entrée
{'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.
Schéma d’entrée
{'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.
Lecture seule Idempotent
Schéma d’entrée
{'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.
Schéma d’entrée
{'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.
Schéma d’entrée
{'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.
Lecture seule Idempotent
Schéma d’entrée
{'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}
Modifié
license_activate
21 September 2026 02:56
Modifié
license_status
21 September 2026 02:56
Modifié
cache_status
21 September 2026 02:56
Modifié
currencies_list
21 September 2026 02:56
Modifié
rate_on
21 September 2026 02:56
Modifié
rate_history
21 September 2026 02:56
Modifié
fx_rates_for
21 September 2026 02:56
Modifié
convert_many
21 September 2026 02:56
Modifié
convert
21 September 2026 02:56
Modifié
rates_latest
21 September 2026 02:56
Modifié
convert_many
19 September 2026 02:47
Ajouté
license_activate
17 September 2026 12:52
Ajouté
license_status
17 September 2026 12:52
Ajouté
cache_status
17 September 2026 12:52
Ajouté
currencies_list
17 September 2026 12:52
Ajouté
rate_on
17 September 2026 12:52
Ajouté
rate_history
17 September 2026 12:52
Ajouté
fx_rates_for
17 September 2026 12:52
Ajouté
convert_many
17 September 2026 12:52
Ajouté
convert
17 September 2026 12:52
Ajouté
rates_latest
17 September 2026 12:52