Currency and forex data your agent can call
Use the same exchangerate.dev data contract through MCP and REST. Every rate includes source and freshness context so an agent can explain what it retrieved. Free MCP rates arrive 15 minutes late, like other Free routes.
claude mcp add --transport http exchangerate-dev https://api.exchangerate.dev/v1/mcp/https://api.exchangerate.dev/v1/mcp/{ "mcpServers": { "exchangerate-dev": { "command": "npx", "args": ["-y", "@nusantara-ventures/exchangerate-mcp"], "env": { "EXCHANGERATE_API_KEY": "exr_live_..." } } }}One server for currency workflows
Fetch current and historical exchange rates, convert amounts, inspect supported currencies, compare USD indices, search the docs, or begin a human-confirmed plan checkout.
| Tool | What it does | Inputs |
list_currencies | Discover supported currency codes, decimal precision, and derived-pair metadata. | none |
get_rate | Fetch a current or historical rate for one currency pair. | base, quote, date? |
get_usd_index | Fetch a complete, time-aligned USD index with its version, weights, source, and observation time. | index (dxy-reconstructed or usd-strength) |
convert | Convert an amount at the current indicative rate with currency-aware rounding. | from, to, amount |
get_range | Retrieve a paginated daily time series for analysis or charting. | base, symbols, start_date, end_date, cursor? |
list_official_rate_tables | List ISO 3166-1 alpha-3 country codes and government-published rate types for use with get_official_rate. | none |
get_official_rate | Retrieve a government-published rate and its validity period for today on any plan or a past date on a paid plan. | country, rate_type, base, quote, date?, direction? |
search_docs | Search canonical API guidance before answering setup, pricing, or sourcing questions. | query, limit? |
start_checkout | Open Checkout or billing management after explicit human confirmation; cancellation creates nothing. | plan (basic, plus, pro) |
First-party tool schemas
The API operator maintains the MCP endpoint and its tool contract.
10,296 currency pairs
Use current rates, conversions, and historical ranges from the same currency catalog.
Freshness included
Responses identify the source, market session, and data update time.
Questions about the MCP server
What is the exchangerate.dev MCP server URL?
Claude Code and other remote-MCP clients can connect directly to the first-party Streamable HTTP endpoint at https://api.exchangerate.dev/v1/mcp/ without installing a local package.
Can I try the FX MCP server without an API key?
Yes for the remote HTTP endpoint; anonymous requests use a shared, IP-capped pool so you can test the real tools and data before signing up. The local stdio bridge requires EXCHANGERATE_API_KEY by default; set ALLOW_ANONYMOUS=true instead to run it keyless on the same anonymous pool. Use a free API key for attributed quota, account limits, and production use.
Do MCP tool calls count against the REST API quota?
Yes. Each MCP tool call counts as one API call against the same per-minute rate limit and monthly quota as the corresponding REST request.
Are the exchange rates suitable for trading or settlement?
No. The rates are indicative developer-grade references for software, analytics, research, and display. They are not executable quotes and must not be used for settlement or regulated trading.
Connect your agent
Follow the setup guide for remote HTTP, local stdio, authentication, and the full tool reference.