Currency Exchange — Real-Time and Historical Rates

by easysolutions906

332 downloads
Not rated
GitHub

About

Currency exchange tools for AI agents. Convert between 30+ currencies, get real-time rates, list supported currencies, and look up historical exchange rates back to 1999. European Central Bank data.

Details

Author
easysolutions906
Downloads
332
Categories
Finance

- currency_convert – convert an amount between two currencies
- currency_rates – get all exchange rates for a base currency
- currency_list – list all 30+ supported currencies
- currency_historical – retrieve historical rates for a specific date (back to 1999)
- Exchange rates cached for 1 hour to improve performance

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Currency Exchange — Real-Time and Historical Rates
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install globally via npx @easysolutions906/mcp-finance. For Claude Desktop, add a finance entry to claude_desktop_config.json; for Cursor, add it to .cursor/mcp.json in your project. The server exposes four tools: currency_convert, currency_rates, currency_list, and currency_historical.

currency_convert

Convert an amount between two currencies using live exchange rates from Frankfurter API. Returns the conversion rate, result, and rate date.

currency_rates

Get all current exchange rates for a base currency. Returns rates for ~30 currencies from Frankfurter API (European Central Bank data).

currency_list

List all supported currency codes and their full names. Frankfurter supports ~30 currencies based on European Central Bank reference rates.

currency_historical

Get historical exchange rates for a specific past date. Uses European Central Bank reference rates. Data available from 1999-01-04 onwards.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "currency exchange \u2014 real-time and historical rates": {
            "finance": {
                "command": "npx",
                "args": [
                    "-y",
                    "@easysolutions906/mcp-finance"
                ]
            }
        }
    }
}

McpServers

{
    "finance": {
        "command": "npx",
        "args": [
            "-y",
            "@easysolutions906/mcp-finance"
        ]
    }
}

MCP Finance Server

A Model Context Protocol (MCP) server providing currency exchange tools for use with Claude Desktop, Cursor, and other MCP clients.

Tools (4 total)

| Tool | Description | |------|-------------| | currency_convert | Convert an amount between two currencies (e.g., USD to EUR) | | currency_rates | Get all exchange rates for a base currency | | currency_list | List all 30+ supported currencies | | currency_historical | Get historical rates for a specific date (back to 1999) |

Install

``bash npx @easysolutions906/mcp-finance `

Claude Desktop

Add to your
claude_desktop_config.json: `json { "mcpServers": { "finance": { "command": "npx", "args": ["-y", "@easysolutions906/mcp-finance"] } } } `

Cursor

Add to
.cursor/mcp.json in your project: `json { "mcpServers": { "finance": { "command": "npx", "args": ["-y", "@easysolutions906/mcp-finance"] } } } `

Data Source

Exchange rates from the Frankfurter API (European Central Bank reference rates). Supports 30+ currencies with rates cached for 1 hour.

Transport

- stdio (default) — for local use with Claude Desktop and Cursor - HTTP — set
PORT env var to start in Streamable HTTP mode on /mcp`
No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.