Exchange Rate

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

python

0

GitHub Stars

python

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

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

You deploy an MCP server that gives real-time currency conversion using the ExchangeRate-API. It supports dozens of currencies and handles common errors, so your applications can convert amounts reliably in any workflow that relies on up-to-date exchange rates.

How to use

You can access currency conversion through your MCP client by calling the convert_currency function exposed by the Exchange Rate MCP Server. This lets you convert an amount from one currency to another using real-time exchange rates. Practical usage patterns include converting a specific amount for pricing, budgeting across currencies, or displaying up-to-date totals for users in their preferred currency.

How to install

Prerequisites you need before installing are Python 3.12 or newer and the uv package manager. You also require an ExchangeRate-API key (a free tier is available). Prepare your environment with these steps.

# Install the uv package manager if you don’t have it
# Then sync/install dependencies for the MCP
uv sync

# Copy the example environment settings to your actual env
cp .env.example .env

# Replace the placeholder with your real API key from ExchangeRate-API
# Edit .env to include your actual key

Configuration

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

Troubleshooting

If you encounter the following issues, apply these checks. “uv: command not found” means the uv tool isn’t installed or the path isn’t provided correctly in your configuration. Ensure uv is installed and you reference the full path to it in your setup.

If you see “Invalid API key,” verify that your .env file contains a valid ExchangeRate-API key. Ensure the key is correctly placed in the environment used by the MCP server and that there are no typos.

Available tools

convert_currency

Converts an amount from one currency to another using real-time exchange rates, enabling practical currency conversion in MCP-enabled workflows.