# Currency Exchange MCP

A Model Context Protocol (MCP) server that provides currency exchange rate conversion tools.

![](images/image.png)

## Features

- Convert amounts between currencies using real-time exchange rates
- Get exchange rates between any two currencies
- Support for historical exchange rates by date
- Uses the reliable fawazahmed0/currency-api for exchange rate data

## Installation

### Claude Code

```bash
claude mcp add currency-exchange-mcp -- npx currency-exchange-mcp
```

### Manual Configuration

Add to your MCP config:

```json
{
  "mcpServers": {
    "currency-exchange-mcp": {
      "command": "npx",
      "args": ["currency-exchange-mcp"]
    }
  }
}
```

## Available Tools

#### 1. `convert_currency`

Converts an amount from one currency to another using current or historical exchange rates.

**Example prompts:**
- *"How much is 10 NOK in USD?"*
- *"Convert 20000 yen to USD"*
- *"How much was 100 USD worth in EUR on 2024-03-15?"*
- *"Convert 500 CAD to JPY"*

#### 2. `get_exchange_rate`

Gets the exchange rate between two currencies.

**Example prompts:**
- *"What's the current exchange rate from EUR to GBP?"*
- *"What's the USD to CHF rate?"*
- *"What was the EUR to USD rate on 2024-01-01?"*

Once configured, Claude will automatically use the appropriate tools when you ask currency-related questions.

## Data Source

This MCP server uses the [fawazahmed0/currency-api](https://github.com/fawazahmed0/exchange-api) which provides:
- Real-time exchange rates
- Historical exchange rates
- Support for 150+ currencies
- Free usage with no API key required

## License

MIT