@exchangerateapi/mcp-server

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. Sourced from Reuters/Refinitiv.

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

| Tool | Description | |------|-------------| | get_exchange_rate | Get the current mid-market rate between two currencies | | get_historical_rates | Get historical data for a pair over 1d, 7d, 30d, or 1y | | get_rates | Multi-target rates with date ranges and grouping (day/week/month) | | list_currencies | List 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

| Variable | Required | Description | |----------|----------|-------------| | EXCHANGE_RATE_API_KEY | Yes | Your API key from exchange-rateapi.com | | EXCHANGE_RATE_BASE_URL | No | Override API base URL (default: https://exchange-rateapi.com/api) |

Links

• API Documentation
• Get Free API Key
• Dashboard
• GitHub

License

MIT