mcpField
E
Exchange Rate MCP Server

Exchange Rate MCP Server

Local
github.com/karashiiroFinance2Updated 81w ago
Repository

About Exchange Rate MCP Server

A small MCP server that retrieves currency exchange rates from the Norges Bank API. Its single tool accepts base and target currencies and an optional date; the project describes itself as a toy, not for serious use.

Key features

  1. 01Fetch rates from Norges Bank API
  2. 02Specify base and target currencies
  3. 03Request a rate for a date
  4. 04Use the latest available rate by default

Use cases

  1. 01Checking a currency pair's rate
  2. 02Looking up a rate for a specified date

MCP support

The server exposes one MCP tool, `exchange_rate`, for clients to request exchange rates from the Norges Bank API.

#exchange-rate#mcp#norges-bank-api

Configuration

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

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

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@karashiiro/exchange-rate-mcp

Tools

1

Saved tool list · updated 3w ago

ParameterTypeRequiredDescription
baseCurrencystringYesThe base currency code (e.g., NOK, USD)
targetCurrencystringYesThe target currency code (e.g., EUR, USD)
datestringNoOptional date in YYYY-MM-DD format. Defaults to latest available rate.

Details

From the project README

Exchange Rate MCP Server

This is a Model Context Protocol (MCP) server that provides access to exchange rate data from the Norges Bank API.

This is just a toy project and isn't meant to be used seriously.

Overview

The Exchange Rate MCP exposes a single tool called exchange_rate that allows an LLM or other clients to fetch exchange rates between different currencies.

Usage

npx -y @karashiiro/exchange-rate-mcp

Development

Installation
pnpm install
Build
pnpm build
Run
pnpm start
Usage

The server exposes a single tool:

exchange_rate

Fetches the exchange rate between two currencies.

Parameters:
  • baseCurrency (string, required): The base currency code (e.g., NOK, USD)
  • targetCurrency (string, required): The target currency code (e.g., EUR, USD)
  • date (string, optional): Date in YYYY-MM-DD format. Defaults to latest available rate.
Example Response:
{
  "baseCurrency": "NOK",
  "targetCurrency": "USD",
  "date": "2025-04-04",
  "rate": 0.12345
}

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.