npm @exchangerateapi/mcp-serverstdioMITupdated 28d ago
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.
What can you do with Exchange Rate API?
@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 institutional interbank market data.
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
License
MIT
Install
Add Exchange Rate API to your client. Pick the one you use.
claude mcp add mcp-server -- npx -y @exchangerateapi/mcp-servercodex mcp add mcp-server -- npx -y @exchangerateapi/mcp-serveramp mcp add mcp-server -- npx -y @exchangerateapi/mcp-server{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@exchangerateapi/mcp-server"
]
}
}
}Add to `claude_desktop_config.json`, then restart Claude Desktop.
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@exchangerateapi/mcp-server"
]
}
}
}Add to `~/.cursor/mcp.json`, or `.cursor/mcp.json` for a single project.
code --add-mcp '{"name":"mcp-server","command":"npx","args":["-y","@exchangerateapi/mcp-server"]}'Or add the block manually to `.vscode/mcp.json` under `servers`.
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@exchangerateapi/mcp-server"
]
}
}
}Add to `~/.codeium/windsurf/mcp_config.json`.
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@exchangerateapi/mcp-server"
]
}
}
}Add to `cline_mcp_settings.json` via the MCP Servers panel.
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@exchangerateapi/mcp-server"
]
}
}
}Add to `~/.gemini/settings.json`.
{
"mcpServers": {
"mcp-server": {
"type": "local",
"command": "npx",
"args": [
"-y",
"@exchangerateapi/mcp-server"
],
"tools": [
"*"
]
}
}
}Add to `~/.copilot/mcp-config.json`, or run `/mcp add` inside the CLI.
{
"context_servers": {
"mcp-server": {
"command": {
"path": "npx",
"args": [
"-y",
"@exchangerateapi/mcp-server"
]
}
}
}
}Add to your Zed `settings.json`.
npx -y @exchangerateapi/mcp-serverRun `goose configure`, choose **Add Extension → Command-line Extension**, and paste this command.
4 tools
Exchange Rate API exposes 4 tools to a connected agent.
- 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
Score
75 / 100
Good
- Documentation22/25
- Maintenance19/25
- Trust16/20
- Capability6/15
- Install experience12/15
- Documents what it does and how to connect
- Has a resolvable package or endpoint
- Exposes at least one tool, prompt or resource
- README has substantive content
- Includes a code example
- Documents its configuration
- Mentions credentials or security posture
- Last commit 20 days ago
- Has a release history
- Repository is not archived
- Licensed MIT
- Namespace verified in the official MCP registry
- Claimed by its owner
- Published under an organisation
- 4 tool(s) documented
- Provides prompt templates
- Provides resources
- 12 documented install method(s)
- Published to a package registry
- Offers a hosted endpoint — no local install
Version history
| Versions | Published |
|---|---|
| 1.0.2Latest | Jun 20, 2026 |