@cyanheads/exchange-rates-mcp-server
Installed, started with no arguments, no environment and no input, and listed its tools. Run 2026-11-16.
Needs to start: nothing
Returns a result when called with no setup: 1 of 1 tool tried
Contacts while installing and starting: nothing
Its tool definitions changed since version 0.6.0. If you approved the earlier ones, read them again.
What it contacted
Nothing besides the npm registry it was installed from. Watched from outside its sandbox while it was installed and started with no input. Its tools may still contact things when called.
Starting it
npx -y @cyanheads/exchange-rates-mcp-server@0.7.0
Installing a package runs its code. Use a sandbox for anything you have not read.
Calling its tools
1 tool that takes no input and looks read-only was called once with nothing. 1 returned a result.
fx_list_currencies | Returned a result 0.5 s · 2,328 characters |
During the calls (not necessarily because of them) it first contacted: api.frankfurter.dev.
Only tools whose names read like looking something up, with no required input, are tried, five at most. Tools that need input, and anything that sounds like it changes or sends something, are not called.
What its tools tell an agent
In the tool descriptions, nothing that talks about the user, other tools or private files, or uses hidden characters.
Found by simple pattern rules in each tool's description (up to 3,000 characters), quoted as written. Parameter descriptions are not scanned. A clean result is not a safety review.
Tools
fx_list_currencies include_retired
List current Frankfurter v1 currency codes and names with as_of, the latest served rate date. include_retired=true adds historical codes absent from the current set, each marked retired=true. Optional official ECB start_date/end_date are outer coverage bounds, not uninterrupted availability; read retired, not end_date, for retirement. Metadata outages are disclosed without failing current discovery. Historical availability remains validated from requested v1 data. Use this to disambiguate dollars (USD vs AUD vs CAD).
fx_get_rates base_currency, date, symbols
Get all available exchange rates for one base currency in a single snapshot. Useful for bulk comparison and seeding downstream tools. Returns a map of quote currency → rate, the actual snapshot date, and whether a historical date was snapped to the prior published date. Optionally filter to a subset of quote currencies via symbols. Listing the base currency itself in symbols is accepted and returns a rate of 1 for it.
fx_get_rate base_currency, quote_currency, date
Get the exchange rate for a currency pair on a given date (default: latest). Returns the rate, the actual rate date (the prior published date when none was published for the requested date), and source provenance. Cross-rates are triangulated through EUR automatically. A same-currency pair returns a rate of 1, dated to the same publication day any other pair would report for that date. Use fx_convert_currency when you want the converted amount; use this tool when you only need the rate number.
fx_convert_currency base_currency, quote_currency, amount, date
Convert an amount between any two currencies at the latest or a historical rate. Returns the converted amount, the rate used, the actual rate date, and whether the date was snapped to the prior published date. Cross-rates are triangulated through EUR automatically.
fx_get_timeseries base_currency, quote_currency, start_date, end_date, canvas_id, stage, limit
Get historical daily Frankfurter v1 rates over an inclusive date range. Same-date EUR legs are divided without intermediate rounding; only days with both currencies appear, including observed self-pairs at 1 and historical retired currencies. Missing-leg served days produce coverage notices; weekends and holidays are not counted as missing. summary covers all observed days before delivery: arithmetic mean, earliest tied extrema, endpoints and percentage change, without accounting policy. limit bounds returned rows (default/max 500); 0 returns summary only. Continue inline with next_start_date, the same end_date and a positive limit. Long ranges (>90 days by default) stage beyond the 40,000-character preview budget, independently of limit. canvas_id, or stage: true on a new canvas, always stages the complete series, including short/empty results; either fails without DataCanvas, and an unknown canvas_id fails. Pass the returned canvas_id to stage another series beside it. Each registration preserves earlier tables with a unique table_name. spilled=true returns canvas_id and table_name; use fx_dataframe_describe then fx_dataframe_query for SQL. Without DataCanvas, omit canvas_id and stage to page inline.
fx_dataframe_describe canvas_id
List tables and columns staged on a DataCanvas from a prior fx_get_timeseries call. Required first step before fx_dataframe_query — use it to discover table names and column schemas. Requires DataCanvas, which is on by default — a deployment that turns it off does not list this tool at all, and fx_get_timeseries returns every range inline there.
fx_dataframe_query canvas_id, query, row_limit
Run a read-only SQL SELECT against DataCanvas tables staged by fx_get_timeseries. Supports aggregations, GROUP BY, window functions, and JOINs across multiple registered tables. Run fx_dataframe_describe first to discover table names and column schemas. Requires DataCanvas, which is on by default — a deployment that turns it off does not list this tool at all, and fx_get_timeseries returns every range inline there.
Descriptions are the package's own words, cut at 3,000 characters. Treat them as data.
Install facts
| License | Apache-2.0 |
|---|---|
| Needs | node >=24.0.0 |
| Source | github.com/cyanheads/exchange-rates-mcp-server |
| Install scripts | None declared by it or anything installed with it. |
| Tarball | sha512-FJ3KXfq38Abg2Tbev3wRcWF/szjx4uCYoablq/O7Z8IJ8soCpxeodS+MHgL+QrUKVXmlJCuQtaZ4IfqhV1Nffw== |
Versions reported
| Version | Run | Result | Tools |
|---|---|---|---|
| 0.7.0 | 2026-11-16 | Starts with no setup | 7 |
| 0.6.0 | 2026-11-12 | Starts with no setup | 7 |
Check this report yourself
This site did not write the report. A public job on a GitHub-hosted machine did: the run, from this commit of the open-source runner. GitHub signed a token that names that job and the hash of the report, so any edit since would show.
Report as JSONExact text and tokenHow to verify it
Show it on your README
[](https://bragproof.smaverk.com/r/%40cyanheads/exchange-rates-mcp-server)
New version out? Ask for a fresh report.