README.md•2.01 kB
# MCP Currency Converter Server
An MCP server that provides real-time currency conversion and exchange rate data using the Frankfurter API.
## Using
URL base is https://currency-mcp.wesbos.com
There are two endpoints - `/mcp` for [streamable HTTP](https://modelcontextprotocol.io/specification/2025-03-26/basic/transports#streamable-http) and `/sse` for legacy HTTP+SSE.
Right now many clients do not offer support for streamable http, so you can use it with a proxy:
```json
{
"mcpServers": {
"currency-conversion": {
"command": "npx",
"args": ["mcp-remote", "https://currency-mcp.wesbos.com/sse"]
}
},
}
```
## Available Tools
### `convert_currency`
Convert an amount from one currency to another.
**Parameters:**
- `from` (string): Source currency code (3 letters, e.g., "USD", "EUR")
- `to` (string): Target currency code (3 letters, e.g., "USD", "EUR")
- `amount` (number): Amount to convert (positive number)
**Example:** Convert 100 USD to EUR
```json
{
"from": "USD",
"to": "EUR",
"amount": 100
}
```
### `get_latest_rates`
Fetch the latest exchange rates.
**Parameters:**
- `base` (string, optional): Base currency code (defaults to EUR)
- `symbols` (string, optional): Comma-separated currency codes to limit results
**Example:** Get USD rates for specific currencies
```json
{
"base": "USD",
"symbols": "EUR,GBP,JPY"
}
```
### `get_currencies`
List all available currencies with their full names.
**Parameters:** None
### `get_historical_rates`
Get historical exchange rates for a specific date.
**Parameters:**
- `date` (string): Date in YYYY-MM-DD format
- `base` (string, optional): Base currency code (defaults to EUR)
- `symbols` (string, optional): Comma-separated currency codes to limit results
**Example:** Get historical EUR rates for January 1, 2024
```json
{
"date": "2024-01-01",
"base": "EUR",
"symbols": "USD,GBP"
}
```
## Data Source
Exchange rate data is provided by the [Frankfurter API](https://frankfurter.dev/)