Exchange Rate MCP Server
About
Toy MCP server that provides access to exchange rate data from the Norges Bank API.
Details
- Author
- karashiiro
- GitHub stars
- 2
- Downloads
- 316
- Categories
- Other
Jump to
- Single tool: exchange_rate for currency conversion.
- Uses the Norges Bank API as data source.
- Supports any currency pair (e.g., NOK, USD, EUR).
- Optional historical date parameter (defaults to latest rate).
- Returns JSON with base, target, date, and rate.
- Lightweight, runs directly via npx.
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:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Exchange Rate MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Run the server via npx -y @karashiiro/exchange-rate-mcp. Once running, use the exchange_rate tool with required parameters baseCurrency and targetCurrency, and optionally date (YYYY-MM-DD format) to retrieve the exchange rate.
exchange_rate
Retrieves exchange rates using Norges Bank's API. Returns rate information including the base currency, target currency, date, and conversion rate.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"exchange rate mcp server": {
"exchange-rate-mcp": {
"command": "npx",
"args": [
"-y",
"@karashiiro/exchange-rate-mcp"
]
}
}
}
}McpServers
{
"exchange-rate-mcp": {
"command": "npx",
"args": [
"-y",
"@karashiiro/exchange-rate-mcp"
]
}
}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
}
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
