Add it to Claude Code
claude mcp add currency-exchange-mcp -- npx -y @ruddxxy/currency-exchange-mcpMake your agent remember this setup
currency-exchange-mcp's config, env vars, and the gotchas you hit — recalled in every future Claude Code, Cursor, and Codex session.
npx conare@latestFree · one command · indexes the sessions already on disk. Set up in the browser instead →
What it does
- Real-time forex and cryptocurrency price lookups
- Multi-source failover for reliable data
- Batch conversion for up to 50 targets per call
- Historical rate lookups for up to 365 days
- Support for 60+ fiat and 30+ cryptocurrencies
Tools 4
convert_currencyConvert an amount between any supported fiat or cryptocurrency pair.batch_convertConvert an amount from one currency to multiple targets in a single call.get_exchange_ratesGet current exchange rates for a base currency against multiple targets.get_historical_rateGet historical exchange rates for a single date or a date range.Try it
Original README from Ruddxxy/currency-exchange-mcp
Currency Exchange & Crypto Rates MCP Server
A currency exchange MCP server for real-time forex rates and cryptocurrency prices via the Model Context Protocol. Convert between 60+ fiat currencies and 30+ cryptocurrencies — with multi-source failover, smart currency resolution, batch conversion, and historical rate lookups. No API keys needed for upstream data sources.
Tools
`convert_currency`
Convert an amount between any supported fiat or cryptocurrency pair.
Input:
{ "amount": 100, "from": "USD", "to": "INR" }
Output:
{
"amount": 100,
"from": "USD",
"to": "INR",
"result": 8312,
"rate": 83.12,
"inverseRate": 0.012031,
"timestamp": "2026-02-14T12:00:00.000Z",
"source": "exchangerate-api",
"cached": false
}
Natural language works too:
{ "amount": 1, "from": "bitcoin", "to": "rupees" }
`batch_convert`
Convert an amount from one currency to multiple targets in a single call. More cost-effective than multiple individual conversions.
Input:
{ "amount": 1000, "from": "USD", "to": ["EUR", "GBP", "INR", "JPY", "BTC"] }
Output:
{
"amount": 1000,
"from": "USD",
"conversions": [
{ "to": "EUR", "result": 920, "rate": 0.92, "inverseRate": 1.086957, "source": "exchangerate-api", "cached": false },
{ "to": "GBP", "result": 790, "rate": 0.79, "inverseRate": 1.265823, "source": "exchangerate-api", "cached": false },
{ "to": "INR", "result": 83120, "rate": 83.12, "inverseRate": 0.012031, "source": "exchangerate-api", "cached": false },
{ "to": "JPY", "result": 149500, "rate": 149.5, "inverseRate": 0.006689, "source": "exchangerate-api", "cached": false },
{ "to": "BTC", "result": 0.02, "rate": 0.00002, "inverseRate": 50000, "source": "coinbase", "cached": false }
],
"timestamp": "2026-02-14T12:00:00.000Z"
}
Supports up to 50 targets per call. Duplicate and same-as-source currencies are automatically filtered.
`get_exchange_rates`
Get current exchange rates for a base currency against multiple targets.
Input:
{ "base": "USD" }
Returns rates for the top 20 currencies (USD, EUR, GBP, JPY, INR, AED, CAD, AUD, CHF, CNY, SGD, HKD, KRW, BRL, MXN, ZAR, TRY, THB, SAR, BTC) by default, or specify targets:
{ "base": "BTC", "targets": ["USD", "EUR", "INR", "GBP"] }
Output:
{
"base": "BTC",
"rates": {
"USD": 51234.56,
"EUR": 47345.12,
"INR": 4258567.12,
"GBP": 40567.89
},
"timestamp": "2026-02-14T12:00:00.000Z",
"source": "coinbase",
"cached": false
}
`get_historical_rate`
Get historical exchange rates for a single date or a date range (max 365 days).
Single date:
{ "base": "USD", "target": "INR", "date": "2025-01-15" }
Output:
{
"base": "USD",
"target": "INR",
"date": "2025-01-15",
"rate": 86.45,
"source": "frankfurter",
"cached": false
}
Date range:
{ "base": "USD", "target": "EUR", "startDate": "2025-01-01", "endDate": "2025-01-31" }
Output:
{
"base": "USD",
"target": "EUR",
"period": { "startDate": "2025-01-01", "endDate": "2025-01-31" },
"rates": [
{ "date": "2025-01-02", "rate": 0.9234 },
{ "date": "2025-01-03", "rate": 0.9241 }
],
"change": {
"high": 0.9312,
"low": 0.9189,
"average": 0.9248,
"changePct": 0.94
},
"source": "frankfurter",
"cached": false
}
Supported Currencies
Fiat (60+ currencies)
| Major | Gulf/Middle East | Asia-Pacific | Americas | Europe | Africa |
|---|---|---|---|---|---|
| USD | AED | INR | BRL | EUR | ZAR |
| EUR | SAR | JPY | MXN | GBP | NGN |
| GBP | KWD | CNY | ARS | CHF | KES |
| JPY | QAR | SGD | CLP | SEK | EGP |
| AUD | BHD | HKD | COP | NOK | GHS |
| CAD | OMR | KRW | PEN | DKK | MAD |
| CHF | JOD | TWD | UYU | PLN | TND |
| CNY | ILS | THB | CZK | ||
| INR | EGP | MYR | HUF | ||
| IQD | PHP | RON | |||
| IRR | IDR | BGN | |||
| LBP | VND | ISK | |||
| BDT | RUB | ||||
| PKR | UAH | ||||
| LKR | HRK |
Crypto (30 coins)
| Symbol | Name | Symbol | Name |
|---|---|---|---|
| BTC | Bitcoin | XRP | Ripple |
| ETH | Ethereum | LTC | Litecoin |
| SOL | Solana | BCH | Bitcoin Cash |
| DOGE | Dogecoin | ATOM | Cosmos |
| ADA | Cardano | NEAR | NEAR Protocol |
| DOT | Polkadot | APT | Aptos |
| AVAX | Avalanche | ARB | Arbitrum |
| MATIC | Polygon | OP | Optimism |
| LINK | Chainlink |