MCP Server

What cahthuranag/mcp-server MCP server does

The cahthuranag/mcp-server MCP server connects MCP-compatible assistants to the AllRatesToday API for foreign-exchange data. It provides current rates between two currencies, historical observations for a selected period, multiple target-currency lookups, and a catalog of supported currencies.

Rates use three-letter ISO 4217 currency codes such as USD, EUR, GBP, or JPY. The current-rate capability returns a mid-market quote, while historical requests return a time series for one of four fixed windows: 1d, 7d, 30d, or 1y. The currency catalog includes codes, names, and symbols and is cached upstream for 24 hours.

How it works

The package runs as a local stdio MCP server. An MCP host launches it as a subprocess, and the host can then discover and call its tools. The server uses the request parameters and, when configured, the API key to query AllRatesToday; conversation context is not sent to the service.

Keyless operation uses the open ECB reference endpoint. In that mode, get_exchange_rate returns an official ECB daily reference rate for supported major currencies, with the rate date and an explanation of the rate type. list_currencies remains available for the supported currency catalog. The authenticated API path provides live mid-market rates for more than 160 currencies, historical series, and multi-target or point-in-time lookups.

Setup and configuration

Run the cahthuranag/mcp-server MCP server with Node’s package runner:

npx -y @allratestoday/mcp-server

Configure that command in an MCP client’s server settings. The README provides setup examples for Claude Code, Cursor, Claude Desktop, Windsurf, and generic stdio clients. The server uses the ALLRATES_API_KEY environment variable when an AllRatesToday key is available. A free key is obtained by registering with AllRatesToday, verifying an email address, and copying the key from the account dashboard.

The process stays running while waiting for an MCP client. It can start without a key, but authenticated functionality requires ALLRATES_API_KEY.

Tools and capabilities

• get_exchange_rate accepts a source and target ISO 4217 code and returns the current rate. Keyless requests use the ECB daily reference path; with a key, the server can return a live mid-market rate.
• get_historical_rates accepts a currency pair and an optional period, defaulting to 7d. Supported periods are 1d, 7d, 30d, and 1y, with granularity determined by the selected window.
• get_rates_authenticated supports several target currencies in one request. It also supports an optional historical timestamp or grouping window.
• list_currencies returns supported currency codes, names, and symbols. Its upstream result is cached for 24 hours.

Limitations and notes

The cahthuranag/mcp-server MCP server returns mid-market or ECB reference data, not necessarily the official rate required for tax, audit, or regulatory reporting. Live mid-market data, historical series, and multi-target lookups require an AllRatesToday API key, while the keyless path is limited to the documented ECB reference and currency-list capabilities. The server supports the MCP 1.x protocol and stdio transport; the client must support that connection style.