# cahthuranag/mcp-server [Health: Active]

**Category:** 💰 Finance & Fintech  
**Repository:** https://github.com/cahthuranag/mcp-server  
**GitHub Stars:** 3  
**npm Downloads (last month):** 1109  
**Views:** 3  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/cahthuranag-mcp-server

## Description
AllRatesToday currency exchange rates: real-time mid-market rates for 160+ currencies (Reuters/Refinitiv), historical data (1d/7d/30d/1y), currency list, and multi-target lookups. Free tier, no key needed for the simple-rate endpoint. Install: npx @allratestoday/mcp-server.

## Tools
Capabilities this server exposes over MCP:

- **get_exchange_rate** — Current mid-market rate between two currencies.
- **get_historical_rates** — Time-series data points for a currency pair over a fixed period.
- **get_rates_authenticated** — Multiple targets in one call, with optional historical timestamp or grouping window.
- **list_currencies** — All supported currencies with codes, names, and symbols. Cached upstream for 24 hours.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "mcp-server": {
    "command": "npx",
    "args": ["-y","@allratestoday/mcp-server"],
    "env": {
      "ALLRATES_API_KEY": ""
    }
  }
}
```

**Requires environment variables:** `ALLRATES_API_KEY` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## 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:

```bash
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.

_Full upstream README: https://allmcps.com/mcp/cahthuranag-mcp-server/readme_