exchange-rates-mcp-server
Server Details
Convert currencies, get FX rates, and query historical Frankfurter v1 exchange rate data.
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- Repository
- cyanheads/exchange-rates-mcp-server
- GitHub Stars
- 1
- Server Listing
- @cyanheads/exchange-rates-mcp-server
- ChatGPT
- –
- Claude
- –
TDQS
Scored across 7 tools
Each tool has a clearly distinct role: conversion vs. single rate vs. bulk snapshot vs. time series vs. currency metadata, plus a paired describe/query workflow for staged DataCanvas tables. The descriptions explicitly clarify the main potential confusion between fx_convert_currency and fx_get_rate.
All tools use a consistent fx_ prefix and snake_case, with mostly verb_noun naming. The two DataCanvas tools use resource_action ordering (fx_dataframe_describe/query), a minor deviation from the otherwise verb_noun pattern.
Seven tools is well-scoped for an exchange-rate server, covering conversion, rate lookup, bulk rates, time series, currency discovery, and optional staged-data SQL without bloat.
The surface covers the core exchange-rate lifecycle: current and historical rates, conversion, bulk snapshots, time series, currency metadata, and optional SQL analysis over staged data. No obvious operational gaps for the stated domain.
Available Tools
7 toolsfx_convert_currencyFx Convert CurrencyARead-onlyIdempotentInspect
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.
Inputs: amount (required), base_currency (required), quote_currency (required), date. Returns: rate, error, source, rate_date, +6 more
fx_dataframe_describeFx Dataframe DescribeARead-onlyIdempotentInspect
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.
Inputs: canvas_id (required). Returns: error, tables, canvas_id, expires_at
fx_dataframe_queryFx Dataframe QueryARead-onlyIdempotentInspect
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.
Inputs: query (required), canvas_id (required), row_limit. Returns: rows, error, notice, canvas_id, +2 more
fx_get_rateFx Get RateARead-onlyIdempotentInspect
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.
Inputs: base_currency (required), quote_currency (required), date. Returns: rate, error, source, rate_date, +4 more
fx_get_ratesFx Get RatesARead-onlyIdempotentInspect
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.
Inputs: base_currency (required), date, symbols. Returns: error, rates, source, rate_date, +3 more
fx_get_timeseriesFx Get TimeseriesBRead-onlyIdempotentInspect
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.
Inputs: end_date (required), start_date (required), base_currency (required), quote_currency (required), +3 more. Returns: error, rates, notice, source, +12 more
fx_list_currenciesFx List CurrenciesARead-onlyIdempotentInspect
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).
Inputs: include_retired. Returns: as_of, count, error, notice, +2 more
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Fetch latest and historical currency exchange rates from Frankfurter. Convert amounts between curr…
Latest and historical ECB foreign-exchange reference rates for 30+ currencies, via Frankfurter.
Convert currencies on the daily European Central Bank reference rates. No API key, no signup.
Convert currencies on the daily European Central Bank reference rates. No API key, no signup.
Related MCP Servers
- AlicenseAqualityDmaintenanceProvides access to currency exchange rates and conversion tools using the Frankfurter API, including latest rates, historical data, and time series from sources like the European Central Bank.5MIT
- AlicenseNot gradedqualityBmaintenanceEnables access to keyless Frankfurter foreign-exchange data, including supported currencies, latest and historical rates, and locally computed currency conversions.70 npmMIT
- AlicenseNot gradedqualityBmaintenanceEnables currency exchange rate lookups, amount conversion, historical rate retrieval, and listing of supported currencies via the Frankfurter API.167 npmMIT
- FlicenseNot gradedqualityDmaintenanceProvides real-time and historical foreign exchange rates for 31+ currencies, enabling currency conversion, historical rate lookups, and time series analysis using data from the Frankfurter API.-
Glama MCP Gateway
Add one secure layer between your agents and this server.