Exchange Rates Mcp Server
Give your coding agent live currency conversion, spot FX quotes, and ECB historical series without hand-rolling Frankfurter API clients.
Overview
io.github.cyanheads/exchange-rates-mcp-server is a MCP server for the Build phase that converts currencies and returns Frankfurter-backed FX and ECB historical rate data to your agent.
What is this MCP server?
- Convert amounts between currency pairs with up-to-date Frankfurter-backed rates
- Fetch current and historical ECB-aligned exchange rate data for charts and reports
- Optional long-range fx_get_timeseries spills to DataCanvas when range exceeds FX_TIMESERIES_CANVAS_THRESHOLD_DAYS (defau
- stdio via npm @cyanheads/exchange-rates-mcp-server (Bun) or hosted streamable-http remote
- Configurable FRANKFURTER_BASE_URL for self-hosted or local API testing
- Published server version 0.1.3
- Default Frankfurter base URL https://api.frankfurter.dev/v1
- Default FX_TIMESERIES_CANVAS_THRESHOLD_DAYS 90
What problem does it solve?
Agents invent FX numbers and you waste time writing one-off HTTP clients every time a feature needs real multi-currency amounts.
Who is it for?
Indie SaaS or ecommerce builders who need dependable conversion and historical FX inside agent-driven feature work.
Skip if: Teams that need bank-grade execution, custom liquidity providers, or trading desks with sub-second tick data.
What do I get? / Deliverables
Your agent can pull authoritative rates and conversions on demand so pricing UIs, reports, and prompts stay aligned with live market data.
- Live conversion and spot rate tool results inside agent sessions
- Historical ECB-aligned series for charts or validation prompts
- Large-range timeseries routed to DataCanvas when above default 90-day threshold
Recommended MCP Servers
Journey fit
FX tools land on the build shelf because solo builders wire them into checkout, dashboards, and agent workflows as live integrations rather than one-off research. Integrations is the canonical home for MCP servers that call external rate APIs and return structured money data to your product or agent.
How it compares
Frankfurter-backed MCP integration for rates, not a spreadsheet skill or a full payments processor.
Common Questions / FAQ
Who is exchange-rates-mcp-server for?
Solo and small-team builders using Claude Code, Cursor, or similar agents who ship products that display or calculate amounts in multiple currencies.
When should I use exchange-rates-mcp-server?
Use it while building checkout, dashboards, or agent tools that must call real FX APIs, or when validating international pricing against historical ECB-aligned series.
How do I add exchange-rates-mcp-server to my agent?
Register the npm package @cyanheads/exchange-rates-mcp-server with stdio transport (Bun, start:stdio) or point MCP config at the streamable-http remote URL from server.json.