# exchange-rates-mcp-server

exchange-rates-mcp-server is an MCP server for Claude Code that retrieves currency rates and converts amounts. It can also fetch historical rates across a date range.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · 1637 installs · ★ 1 repo stars
- Author: cyanheads
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/cyanheads/exchange-rates-mcp-server
- Updated: 2026-10-24
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/exchange-rates-mcp-server

## What it does

The server gives an agent tools to list currencies, look up current or past rates, and convert amounts. It can return a rate for a currency pair or daily observations across a date range from Frankfurter v1.

No API key is needed. Historical data starts on 1999-01-04; a weekend or holiday query can resolve to the previous business day. Table tools can inspect and query series staged by an earlier request. They use DataCanvas with DuckDB, enabled by default.

## Requirements
- Remote server: `https://exchange-rates-mcp-server--cyanheads.run.tools`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http exchange-rates-mcp-server https://exchange-rates-mcp-server--cyanheads.run.tools
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add exchange-rates-mcp-server --url https://exchange-rates-mcp-server--cyanheads.run.tools
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "exchange-rates-mcp-server": {
            "url": "https://exchange-rates-mcp-server--cyanheads.run.tools"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "exchange-rates-mcp-server": {
            "type": "http",
            "url": "https://exchange-rates-mcp-server--cyanheads.run.tools"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http exchange-rates-mcp-server https://exchange-rates-mcp-server--cyanheads.run.tools
```

## When to use it
- look up the current rate for a currency pair
- convert an amount using a historical rate
- retrieve daily rates over a date range
- list supported currencies and their codes

## Example prompts
- Show the current EUR to USD rate.
- Convert 100 USD to EUR using the historical rate for a date.
- Get a GBP to EUR rate series for a date range.

## Similar
- [AllRatesToday exchange rates (hosted)](https://affpapa.org/en/nevibecode/mcp/allratestoday-exchange-rates-hosted.md) — MCP server · ★ 4 repo stars
- [anirbanbasu-frankfurtermcp](https://affpapa.org/en/nevibecode/mcp/anirbanbasu-frankfurtermcp.md) — MCP server · ★ 6 repo stars
- [Currency Exchange](https://affpapa.org/en/nevibecode/mcp/currency-exchange.md) — MCP server · ★ 1 repo stars
- [Exchange Rate API](https://affpapa.org/en/nevibecode/mcp/exchange-rate-api.md) — MCP server · 273 installs
- [BNR exchange rates](https://affpapa.org/en/nevibecode/mcp/bnr-exchange-rates.md) — MCP server · ★ 5 repo stars
- [open-exchange-rates](https://affpapa.org/en/nevibecode/skills/open-exchange-rates.md) — skill · 188 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
