Currency Exchange MCP Server

1

Add it to Claude Code

Run this in a terminal.

Run in terminal
claude mcp add currency-exchange-mcp -- npx -y @ruddxxy/currency-exchange-mcp
README.md

Real-time currency exchange rates and crypto prices via 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

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.

Configuration

claude_desktop_config.json
{"mcpServers": {"currency-exchange": {"command": "npx", "args": ["-y", "@ruddxxy/currency-exchange-mcp"]}}}

Try it

Convert 100 USD to INR.
How much is 1 Bitcoin in Indian Rupees?
Convert 1000 USD to EUR, GBP, and BTC in one go.
What is the exchange rate for USD against the top 20 currencies?
Show me the historical exchange rate for USD to INR on January 15, 2025.

Frequently Asked Questions

What are the key features of Currency Exchange MCP?

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.

What can I use Currency Exchange MCP for?

Quickly checking current crypto prices during financial analysis. Automating currency conversion calculations in reports. Comparing historical currency performance for research. Batch converting travel budgets into multiple local currencies.

How do I install Currency Exchange MCP?

Install Currency Exchange MCP by running: npx -y @ruddxxy/currency-exchange-mcp

What MCP clients work with Currency Exchange MCP?

Currency Exchange MCP works with any MCP-compatible client including Claude Desktop, Claude Code, Cursor, and other editors with MCP support.

Turn this server into reusable context

Keep Currency Exchange MCP docs, env vars, and workflow notes in Conare so your agent carries them across sessions.

Need the old visual installer? Open Conare IDE.
Open Conare