Fxrates

io.github.CloudCorpRecordsPublished by GitHub account CloudCorpRecordsv0.1.0Updated Nov 3, 2026

Frankfurter FX rates: currencies, latest and historical rates, and conversions, keyless.

VerifiedSTDIODesktop only

Overview

Fxrates's local MCP server; no sign-in required; STDIO.

No AI overview yet: these facts come from the registry entry and the server itself.

Installation

In SourceWeft

  1. Open Fxrates in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

fxrates

fxrates reads foreign-exchange data from the Frankfurter API: which currencies are supported, what the latest rates are, what the rates were on a single past date or across a range, and conversions between currencies worked out locally from the fetched rate. One binary serves a command-line interface and a stdio MCP server.

No API key is needed. The service is keyless, so fxrates works with nothing configured. The API base URL can be overridden with FRANKFURTER_API_URL; when it is not set, calls go to https://api.frankfurter.dev/v1.

Install

bash
npx @reneturcios/fxrates currencies

Or run the container image:

bash
docker run -i ghcr.io/cloudcorprecords/fxrates

The container defaults to the MCP server (see below). Pass CLI arguments to use it as a CLI instead.

CLI

bash
fxrates currenciesfxrates latest --base USD --symbols EUR,GBPfxrates convert 25 EUR USDfxrates historical 2024-05-01 --base EUR --symbols USDfxrates range 2024-05-01 2024-05-03 --base EURfxrates convert-on 2020-01-02 100 USD EURfxrates greet Ada
fxrates --version

Rate commands print the upstream JSON payload. Conversions print a JSON object with amount, from, to, rate, converted, and date when the API supplies one. Exit codes: 0 on success, 1 when a call fails (including an upstream API error), 2 for usage errors.

Conversions are computed locally: the tool fetches the single rate it needs and multiplies. The result is trimmed to at most six decimal places by rounding at the sixth place; no fee, spread, or extra rounding is applied.

MCP server

One bin serves both faces. The mcp subcommand starts a stdio MCP server:

bash
npx -y @reneturcios/fxrates mcp

MCP client configuration:

json
{  "mcpServers": {    "fxrates": {      "command": "npx",      "args": ["-y", "@reneturcios/fxrates", "mcp"]    }  }}

To point the server at a different Frankfurter-compatible host, add FRANKFURTER_API_URL to the client's env for this server.

Tools

ToolInputWhat it returns
get_supported_currencies(none)The map of supported currency codes to names.
get_latest_exchange_ratesbase, symbols (both optional)The latest rates payload.
convert_currency_latestamount, from, to (all required)A conversion at the latest rate: amount, pair, rate, converted value, and date.
get_historical_exchange_ratesdate or start_date/end_date, plus optional base, symbolsRates for one date or a range.
convert_currency_specific_datedate, amount, from, to (all required)A conversion at that date's rate.
greetname (optional)A greeting string. Present for internal testing.

Dates use YYYY-MM-DD. symbols is a comma-separated list such as USD,GBP. Currency arguments are codes such as EUR and USD.

Development

bash
npm installnpm run build   # tsc -> dist/npm test        # node test runner over test/*.test.ts, no network (fake fetch fixtures)npm run dev     # run the CLI from source via tsx

License

MIT — see LICENSE.

Source: README.md at commit 0f30afe

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.0LatestNov 3, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts