exchange-rate-mcp

sin4ch/exchange-rate-mcp

3.1

If you are the rightful owner of exchange-rate-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

The Exchange Rate MCP Server is a Model Context Protocol server that provides real-time currency conversion using the ExchangeRate-API.

Exchange Rate MCP Server

A Model Context Protocol (MCP) server that provides currency conversion functionality using the ExchangeRate-API.

Features

  • Convert amounts between different currencies using real-time exchange rates
  • Support for about 161 currencies currently
  • Error handling for invalid currency codes, API errors, and network issues

Setup

Prerequisites

  • Python 3.12+
  • uv package manager
  • ExchangeRate-API key (free tier available)

Installation

  1. Clone this repository

  2. Install dependencies:

    uv sync

  3. Copy the .env.example file into your .env:

    cp .env.example .env

  4. Replace your_api_key in the .env with your actual API key.

    You can get your free API key from ExchangeRate-API

Configuration

Copy and paste this in the claude_desktop_config.json file:

{
  "mcpServers": {
    "exchange-rate-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/exchange-rate-mcp",
        "run",
        "main.py"
      ]
    }
  }
}

Usage

Once configured, you can use the convert_currency tool in Claude to convert between currencies:

  • convert_currency(100, "USD", "EUR") - Convert 100 USD to EUR
  • convert_currency(50, "GBP", "JPY") - Convert 50 GBP to JPY

Troubleshooting

  • "uv: command not found": Make sure uv is installed and the full path is specified in the configuration
  • "Invalid API key": Check that your .env file contains a valid ExchangeRate-API key