English Français العربية

Exchange Rate API

Official registry Other

Real-time & historical exchange rates for 160+ currencies, mid-market (Reuters/Refinitiv).

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package @exchangerateapi/mcp-server
Claude Code 
claude mcp add exchange-rate-api -e 'EXCHANGE_RATE_API_KEY=<your exchange_rate_api_key>' -- npx -y @exchangerateapi/mcp-server@1.0.2
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "exchange-rate-api": {
            "command": "npx",
            "args": [
                "-y",
                "@exchangerateapi/mcp-server@1.0.2"
            ],
            "env": {
                "EXCHANGE_RATE_API_KEY": "<your exchange_rate_api_key>"
            }
        }
    }
}

Environment variables

  • EXCHANGE_RATE_API_KEY required secret API key from exchange-rateapi.com (free tier available, no credit card required)

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. @exchangerateapi/mcp-server
  2. Quick Setup
  3. Tools
  4. Example Prompts
  5. Environment Variables
  6. Links
  7. License

@exchangerateapi/mcp-server

Exchange Rate API is now **AllRatesToday.** This package keeps working against exchange-rateapi.com, but it is no longer updated. For new projects use @allratestoday/mcp-server (or the hosted endpoint https://allratestoday.com/api/mcp) — the same real-time API plus official rates from 121 central banks. Docs: allratestoday.com/docs.

MCP server that gives AI coding tools (Claude Code, Cursor, Claude Desktop, Windsurf) access to real-time and historical currency exchange rates from Exchange Rate API.

160+ currencies. Mid-market rates updated every 60 seconds, no retail spread.

Quick Setup

1. Get a Free API Key

Sign up at exchange-rateapi.com/register — free tier, no credit card.

2. Add to Your MCP Client

Claude Code (~/.claude/settings.json):

{
  "mcpServers": {
    "exchange-rateapi": {
      "command": "npx",
      "args": ["-y", "@exchangerateapi/mcp-server"],
      "env": { "EXCHANGE_RATE_API_KEY": "era_live_..." }
    }
  }
}

Cursor (.cursor/mcp.json):

{
  "mcpServers": {
    "exchange-rateapi": {
      "command": "npx",
      "args": ["-y", "@exchangerateapi/mcp-server"],
      "env": { "EXCHANGE_RATE_API_KEY": "era_live_..." }
    }
  }
}

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "exchange-rateapi": {
      "command": "npx",
      "args": ["-y", "@exchangerateapi/mcp-server"],
      "env": { "EXCHANGE_RATE_API_KEY": "era_live_..." }
    }
  }
}

Windsurf (~/.windsurf/mcp.json):

{
  "mcpServers": {
    "exchange-rateapi": {
      "command": "npx",
      "args": ["-y", "@exchangerateapi/mcp-server"],
      "env": { "EXCHANGE_RATE_API_KEY": "era_live_..." }
    }
  }
}

Tools

ToolDescription
get_exchange_rateGet the current mid-market rate between two currencies
get_historical_ratesGet historical data for a pair over 1d, 7d, 30d, or 1y
get_ratesMulti-target rates with date ranges and grouping (day/week/month)
list_currenciesList all 160+ supported currencies

Example Prompts

Once configured, ask your AI assistant:

  • "What's the current USD to EUR exchange rate?"
  • "Show me GBP/JPY rates for the last 30 days"
  • "Convert 5000 USD to EUR, GBP, and JPY"
  • "List all supported currencies"
  • "What's the monthly average EUR/USD rate for 2026?"

Environment Variables

VariableRequiredDescription
EXCHANGE_RATE_API_KEYYesYour API key from exchange-rateapi.com
EXCHANGE_RATE_BASE_URLNoOverride API base URL (default: https://exchange-rateapi.com/api)

License

MIT

Frequently asked questions

What is Exchange Rate API?

Real-time & historical exchange rates for 160+ currencies, mid-market (Reuters/Refinitiv).

How do I install Exchange Rate API?

It runs on your machine. In Claude Code: claude mcp add exchange-rate-api -e 'EXCHANGE_RATE_API_KEY=<your exchange_rate_api_key>' -- npx -y @exchangerateapi/mcp-server@1.0.2. For other clients, paste the JSON configuration from this page into their MCP settings.

Does Exchange Rate API need an API key?

Yes. It expects EXCHANGE_RATE_API_KEY, which you set in its configuration.

Is Exchange Rate API open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains Exchange Rate API?

It is published by Exchange-RateAPI. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.