Skip to main content
Glama

exchange-rates-mcp-server

Server Details

Convert currencies, get FX rates, and query historical Frankfurter v1 exchange rate data.

If you are the author of this connector, you can claim ownership. Claimed connector authors can inspect health checks, view analytics, and manage their listing.
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

A4.1/5.0

Scored across 7 tools

Disambiguation5/5

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.

Naming Consistency4/5

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.

Tool Count5/5

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.

Completeness5/5

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 tools
fx_convert_currencyFx Convert CurrencyA
Read-onlyIdempotent
Inspect

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 DescribeA
Read-onlyIdempotent
Inspect

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 QueryA
Read-onlyIdempotent
Inspect

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 RateA
Read-onlyIdempotent
Inspect

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 RatesA
Read-onlyIdempotent
Inspect

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 TimeseriesB
Read-onlyIdempotent
Inspect

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 CurrenciesA
Read-onlyIdempotent
Inspect

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

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Provides 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.
      5
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables access to keyless Frankfurter foreign-exchange data, including supported currencies, latest and historical rates, and locally computed currency conversions.
      70 npm
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables currency exchange rate lookups, amount conversion, historical rate retrieval, and listing of supported currencies via the Frankfurter API.
      167 npm
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Provides 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.
      -
    Try in Browser

    Glama MCP Gateway

    Add one secure layer between your agents and this server.