mcpField
C
Currency Exchange — Real-Time and Historical Rates

Currency Exchange — Real-Time and Historical Rates

Local
github.com/easysolutions906Finance0Updated 33w ago
Repository

About Currency Exchange — Real-Time and Historical Rates

An MCP server for currency conversion and exchange-rate lookups, using European Central Bank reference data via the Frankfurter API. It supports current and historical rates for more than 30 currencies.

Key features

  1. 01Convert between supported currencies
  2. 02Retrieve rates for a base currency
  3. 03List supported currencies
  4. 04Look up historical rates back to 1999
  5. 05stdio and Streamable HTTP transports

Use cases

  1. 01Convert amounts between currencies
  2. 02Check current rates for a base currency
  3. 03Retrieve a rate for a past date

MCP support

Exposes four currency tools to MCP clients: conversion, base-currency rates, currency listing, and historical-rate lookup. It supports stdio by default and Streamable HTTP when configured with `PORT`.

#currency#finance#exchangerates#conversion#mcp

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "finance": {
      "command": "npx",
      "args": [
        "-y",
        "@easysolutions906/mcp-finance"
      ]
    }
  }
}
Run commandnpx -y @easysolutions906/mcp-finance

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@easysolutions906/mcp-finance

Tools

4

Saved tool list · updated 3w ago

ParameterTypeRequiredDescription
fromstringYesSource currency code, 3 uppercase letters (e.g., "USD", "EUR", "GBP")
tostringYesTarget currency code, 3 uppercase letters (e.g., "EUR", "JPY", "CAD")
amountnumberNoAmount to convert (default 1)

Details

From the project README

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)

ToolDescription
currency_convertConvert an amount between two currencies (e.g., USD to EUR)
currency_ratesGet all exchange rates for a base currency
currency_listList all 30+ supported currencies
currency_historicalGet historical rates for a specific date (back to 1999)

Install

npx @easysolutions906/mcp-finance
Claude Desktop

Add to your claude_desktop_config.json:

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

Add to .cursor/mcp.json in your project:

{
  "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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.