io.github.theluckystrike/currency-exchange

Official10 toolsLive

by theluckystrike · JavaScript

Convert currencies on the daily European Central Bank reference rates. No API key, no signup.

io.github.theluckystrike/currency-exchange MCP Server

The io.github.theluckystrike/currency-exchange MCP server converts currencies using daily European Central Bank reference rates. It is designed to perform conversions without requiring an API key or any signup process. The server provides a straightforward way to access exchange-rate-based calculations grounded in ECB daily data.

🛠️ Key Features

Converts currencies using daily European Central Bank reference rates
No API key required
No signup required

🚀 Use Cases

Currency conversion based on ECB daily reference rates
Developer workflows needing ECB-rate calculations without authentication

⚡ Developer Benefits

Simplified integration (no API key)
Faster setup (no signup)

⚠️ Limitations

Conversion is tied to daily European Central Bank reference rates

Topics

claudecursorinvoicemcpmcp-servermodel-context-protocolspreadsheetaccountingai-toolsbookkeepingclaude-desktopfreelanceinvoicinglocal-firstmcp-serverspdfself-hostedtime-trackingvatproductivity

Captured live from the server via tools/list.

rates_latest

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.

Parameters2

base	string	optional	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	array	optional	Only these currencies, at most 200. Omit for all of them

Raw schema

{
  "type": "object",
  "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,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

convert

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.

Parameters4

amount	number	required	Amount in major units of the from currency, e.g. 100 or 12.34
from	string	required	Currency the amount is in. Cross rates go through the euro, the only pair the ECB publishes
to	string	optional	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	string	optional	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

Raw schema

{
  "type": "object",
  "properties": {
    "amount": {
      "type": "number",
      "description": "Amount in major units of the from currency, e.g. 100 or 12.34"
    },
    "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"
    },
    "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"
    }
  },
  "required": [
    "amount",
    "from"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

convert_many

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.

Parameters3

amount	number	required
from	string	required
to	array	required	Target currencies

Raw schema

{
  "type": "object",
  "properties": {
    "amount": {
      "type": "number"
    },
    "from": {
      "type": "string",
      "pattern": "^[A-Za-z]{3}$"
    },
    "to": {
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^[A-Za-z]{3}$"
      },
      "minItems": 1,
      "maxItems": 60,
      "description": "Target currencies"
    }
  },
  "required": [
    "amount",
    "from",
    "to"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

fx_rates_for

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.

Parameters2

target	string	optional	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	array	required	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

Raw schema

{
  "type": "object",
  "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}$"
      },
      "minItems": 1,
      "maxItems": 60,
      "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"
    }
  },
  "required": [
    "currencies"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

rate_history

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.

Parameters6

from	string	required	Base currency of the pair
to	string	required	Quote currency of the pair. Each row is 1 from = X to
days	integer	optional	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_date	string	optional	ISO date, inclusive. Overrides days. Free is limited to the last 90 days
to_date	string	optional	ISO date, inclusive, default today
max_rows	integer	optional	Cap the table, default 200. min/max/avg still cover the whole window

Raw schema

{
  "type": "object",
  "properties": {
    "from": {
      "type": "string",
      "pattern": "^[A-Za-z]{3}$",
      "description": "Base currency of the pair"
    },
    "to": {
      "type": "string",
      "pattern": "^[A-Za-z]{3}$",
      "description": "Quote currency of the pair. Each row is 1 from = X to"
    },
    "days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 20000,
      "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_date": {
      "type": "string",
      "maxLength": 10,
      "description": "ISO date, inclusive. Overrides days. Free is limited to the last 90 days"
    },
    "to_date": {
      "type": "string",
      "maxLength": 10,
      "description": "ISO date, inclusive, default today"
    },
    "max_rows": {
      "type": "integer",
      "minimum": 1,
      "maximum": 2000,
      "description": "Cap the table, default 200. min/max/avg still cover the whole window"
    }
  },
  "required": [
    "from",
    "to"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

rate_on

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.

Parameters3

from	string	required	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
to	string	required	Quote currency. The rate returned is 1 from = X to
date	string	required	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

Raw schema

{
  "type": "object",
  "properties": {
    "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"
    },
    "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"
    }
  },
  "required": [
    "from",
    "to",
    "date"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

currencies_list

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.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

license_activate

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.

Parameters1

key

string

required

License key from checkout, MCPL1.<payload>.<signature>

Raw schema

{
  "type": "object",
  "properties": {
    "key": {
      "type": "string",
      "description": "License key from checkout, MCPL1.<payload>.<signature>"
    }
  },
  "required": [
    "key"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

servers/currency/README.md8 KBView on GitHub

mcp-currency

Ask your assistant what something is worth in another currency and get a real answer with a date on it. It reads the European Central Bank's daily euro foreign exchange reference rates, the same published series banks, tax authorities and accountants use, converts amounts between any of the currencies the ECB quotes, and shows how a pair has moved over time. There is no API key, no account and no rate limit, because the ECB publishes the file openly. Both files are cached on your own machine, so after the first download every answer is instant and the server keeps working on a plane. Every answer states which rate date it used, because ECB rates are published once a day and a Sunday carries Friday's rate.

Built by theluckystrike.

In the official MCP Registry (io.github.theluckystrike/currency-converter-ecb-rates-daily-keyless).

Listed on the AI Product Index - live remote endpoint at mcp.zovo.one/s/currency, free tier, no signup.

currency demo

60-second install

npm publish for @theluckystrike/mcp-currency is pending. Until then, the .mcpb one-click bundle or a clone+build is the working path, both are verified below.

One-click (.mcpb): download currency.mcpb from the latest release and double-click it in Claude Desktop: https://github.com/theluckystrike/mcp-servers/releases/latest

(claude_desktop_config.json):

json

{
  "mcpServers": {
    "currency": {
      "command": "npx",
      "args": ["-y", "@theluckystrike/mcp-currency"]
    }
  }
}

Claude Code:

claude mcp add currency -- npx -y @theluckystrike/mcp-currency

(.cursor/mcp.json):

json

{
  "mcpServers": {
    "currency": {
      "command": "npx",
      "args": ["-y", "@theluckystrike/mcp-currency"]
    }
  }
}

The npx form above starts working the moment the package is published. Until then, use the .mcpb bundle above, or build from source with exactly these three commands:

git clone https://github.com/theluckystrike/mcp-servers.git && cd mcp-servers
npm install
npm run build -w packages/mcp-license -w servers/currency

Then point your client's command at node with one arg: the absolute path to servers/currency/dist/index.js.

To run in Pro mode set MCP_LICENSE_KEY in the same config block, or call license_activate once with your key.

Tools

Tool	What it does
`rates_latest`	The latest ECB reference rates, re-expressed against any base. Optional `quotes` to narrow the list.
`convert`	Convert an amount between two currencies, today or on a past date. States the rate, the rate date and the rounding.
`convert_many`	One amount into several currencies at once, all off the same rate date.
`fx_rates_for`	Returns the `fx_rates` object the expense tracker's `expense_to_invoice` takes, plus the rate date.
`rate_history`	A pair over a window, with min, max, average and the change across it.
`rate_on`	The rate on one date, falling back to the last published rate on or before it and saying so. Both directions are returned (`rate` and `inverse_rate`) and `published_direction` names which way round the ECB itself quotes the pair, so the reciprocal is never relayed as the published figure.
`currencies_list`	Every currency the ECB quotes, with its euro rate and its number of decimal places.
`cache_status`	What is cached, how old it is, when it refreshes next, and where it lives.
`license_status` / `license_activate`	Check or activate a Pro key. Verified offline.

Resource fx://latest exposes the cached rates as JSON. Prompt convert_invoice_lines walks the whole expense-tracker -> currency -> invoice chain in one step.

Free vs Pro

	Free	Pro ($19 one-time)
Latest rates, `convert`, `convert_many`, `fx_rates_for`	Yes, unlimited	Yes, unlimited
Currencies	All 30+ the ECB quotes	All 30+ the ECB quotes
Rate history	Up to 90 days per call, back 90 days; a wider window is shortened and answered, cap named	Unlimited windows, back to 1999-01-04
`rate_on`	Last 90 days	Any date since 1999-01-04
Offline cache	Yes	Yes

A refused history window returns the reason and the exact narrower call to make; it never silently truncates a table and it never returns a transport error.

Get Pro: https://mcp.zovo.one/buy/currency (or $39 for the whole bundle: https://mcp.zovo.one/buy/bundle)

Pairs with

expense-tracker, expense_to_invoice takes target_currency plus an fx_rates object and folds a multi-currency expense set into one invoice currency, but it will not fetch or invent a rate. fx_rates_for {target, currencies} here returns exactly that object. "Rebill Nova in USD" then works end to end without the user typing a single exchange rate.
invoice, one invoice carries one currency. Convert first, issue second, and put the returned invoice_note ("Converted at ECB reference rates of 2026-09-02") on the document so the client can check it.

code

expense_to_invoice {project, from, to}          -> which currencies are actually present
fx_rates_for {target: "USD", currencies: [...]} -> {"EUR": 1.0812, "GBP": 1.2717}, rate date
expense_to_invoice {..., target_currency: "USD", fx_rates: {...}} -> one currency, every line annotated
invoice_create {currency: "USD", items: [...]}  -> the document

How the rates work

Source: the ECB euro foreign exchange reference rates, eurofxref-daily.xml and eurofxref-hist.xml.
Published around 16:00 CET on TARGET business days. There is no rate for a weekend, 1 January, Good Friday, Easter Monday, 1 May, or 25 and 26 December.
Asking for a date with no rate returns the last rate published on or before it, the convention every bank uses, and the answer says which date it landed on and why. A date inside the cached range with no rate is a weekend or a TARGET holiday and is named as one; a date after the newest day in the cache is reported as not published yet, with the cache's latest date and whether this call went to the ECB to look for it.
The ECB quotes everything against the euro, so a USD/PLN rate is a cross rate: the ratio is formed and multiplied at full precision, and the only rounding in the path is the last one, to the target currency's minor units. The answer carries both numbers: rate_exact is the multiplier, rate is the same rate rounded to 6 decimals for reading. Recomputing by hand from the 6-decimal rate can differ by a minor unit or two; it is far out for pairs whose rate is nowhere near 1 (1,000,000 VND is KWD 11.667, not KWD 12.000).
Results are rounded to the target currency's own ISO 4217 minor units: JPY comes back whole, BHD to three places.
These are reference rates for accounting and reporting. They are not dealing rates; your bank's rate will differ.

Privacy

All data stays local. The only network request this server makes is to www.ecb.europa.eu for the two public rate files, and only when the local copy is older than 6 hours (daily) or 24 hours (history). Nothing about your amounts, your currencies or your machine is sent anywhere. The cache lives in ${XDG_DATA_HOME:-~/.local/share}/mcp-servers/currency/; delete that directory to reset the server. Set ECB_BASE_URL to point at your own mirror if outbound access is restricted.

MIT licensed. Support: support@zovo.one. Built by theluckystrike.

Use these docs as an MCP server

Any MCP client (Claude, Cursor, Windsurf, VS Code) can read this repository's documentation directly via GitMCP - no install:

Docs MCP URL: https://gitmcp.io/theluckystrike/mcp-currency

Install

Tools (10)

rates_latestconvertconvert_manyfx_rates_forrate_historyrate_oncurrencies_listcache_status

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://mcp.zovo.one/mcp/currency-exchange

Configuration

Environment variables

MCP_LICENSE_KEYsecret

Optional Pro license key (MCPL1....). Verified offline.

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "currency-exchange": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.zovo.one/mcp/currency-exchange"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

io.github.theluckystrike/currency-exchange MCP Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

rates_latest

convert

convert_many

fx_rates_for

rate_history

rate_on

currencies_list

cache_status

license_status

license_activate

mcp-currency

60-second install

Tools

Free vs Pro

Pairs with

How the rates work

Privacy

Use these docs as an MCP server

Install

Remote endpoint

Configuration

Related servers