Log inSubmit server
MCP Server logo

MCP Server

by cahthuranag

Fetches live, historical, official, and multi-currency exchange rates through MCP, with keyless central-bank data.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install MCP Server

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "cahthuranag-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@allratestoday/mcp-server"
      ],
      "env": {
        "ALLRATES_API_KEY": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Install not yet sandbox-tested— the server itself is confirmed live (we called its tools/list endpoint). The stdio install command is a separate, ongoing check.

Overview

cahthuranag/mcp-server connects MCP clients to AllRatesToday for currency conversion, exchange-rate history, currency validation, and central-bank data. It runs as a stdio process launched by an MCP host, with a hosted Streamable HTTP endpoint also available. Keyless use provides supported currency metadata and selected official or reference rates; an API key enables broader mid-market and multi-target lookups. Reach for it when an agent needs fiat exchange-rate data rather than cryptocurrency, commodity, or arithmetic conversion support.

Use cases

  • Convert a fiat currency pair using a current rate
  • Compare one currency against several targets
  • Review a currency pair over a fixed historical window
  • Validate ISO currency codes before making rate queries
  • Retrieve official central-bank or daily reference rates

Key features

  • Live mid-market fiat exchange rates
  • Fixed-window historical rate series
  • Multi-target and point-in-time lookups
  • ISO 4217 currency catalog
  • Official central-bank and reference rates
  • Keyless mode with optional API authentication

Tools4

What MCP Server lets your agent do. Expand a tool for its parameters.

Verified live~1.3k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 1d ago

Recent health check succeeded.

18/18 checks healthy over the last 77d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 8d ago via OSV.dev · @allratestoday/mcp-server (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars4Stargazers on the source repository.
npm downloads1.8kPackage downloads in the last 30 days.
Last commit3d agoMost recent push to the default branch.
Tools exposed4Callable tools this server registers over MCP.
Directory activity8 viewsConfig copies, upvotes, and views on AllMCPs.

How MCP Server works

What cahthuranag/mcp-server does

cahthuranag/mcp-server gives MCP-compatible assistants access to AllRatesToday currency data. Its primary use is querying fiat exchange rates: current pairs, fixed lookback periods, multiple target currencies, and rates for a specified past time. The currency catalog covers more than 150 ISO 4217 fiat codes, while live mid-market data covers more than 160 currencies through the API.

The package also exposes official central-bank tables, daily reference rates, central-bank metadata, and a tool for requesting a trial key. Official rates and mid-market rates serve different purposes: mid-market values are suited to current market-oriented conversions, while official tables retain the publishing institution's rate date and are more appropriate when an institution-specific published rate is required.

How it works

An MCP client launches the package as a subprocess over stdio. The zero-install form uses npx -y @allratestoday/mcp-server; a global npm installation provides the allratestoday-mcp command. A hosted Streamable HTTP endpoint is also available at https://allratestoday.com/api/mcp for clients that support remote MCP connections.

Without an API key, the server can query open central-bank data. Keyless exchange-rate responses identify the bank, publication date, and whether a value was derived by inversion. Only pairs available from the relevant published table work through that path. A key enables real-time mid-market access, multi-target lookups, and authenticated time-based queries. Historical mid-market series, point-in-time rates, and dated official or reference tables require a paid plan.

Setup and configuration

Install by adding the stdio command to the MCP client's configuration, or run the package globally with npm. Set ALLRATES_API_KEY to an AllRatesToday key when authenticated API access is needed. The server continues running without that variable and uses its keyless capabilities.

A trial key can also be requested through the request_trial_key tool. Keyless use requires visible, followable attribution to AllRatesToday wherever the returned rates are displayed. When using a hosted endpoint with authentication, an authorization header is preferable to putting the key in the URL.

Tools and capabilities

  • get_exchange_rate returns one current fiat-to-fiat rate. It does not perform amount arithmetic and does not cover cryptocurrencies or commodities.
  • get_historical_rates returns a fixed lookback ending now: hourly samples for one day, daily samples for seven or 30 days, and weekly samples for one year.
  • get_rates_authenticated handles one source against several targets or a requested historical time, with optional hour, day, week, or month bucketing.
  • list_currencies returns supported currency codes, names, symbols, and a count. It is useful for validating input before making another query.
  • list_central_banks reports available institutions and their latest publication dates.
  • get_official_rates retrieves the latest official table, or a selected pair, from supported institutions.
  • get_reference_rate retrieves the daily reference table fixed at 16:00 London time.
  • request_trial_key issues a temporary trial key for the session.

Limitations and notes

The package focuses on fiat currencies and does not provide cryptocurrency or commodity rates. A fixed historical window always ends at the current time; use the authenticated time parameter for a specific past timestamp. Official central-bank rates can differ materially from live mid-market rates, so the tool should be selected according to whether the workflow needs a market quote or an institution's published figure.

The stdio package and hosted endpoint are not identical: the hosted service includes additional central-bank tools from the sibling server. API keys should be kept out of committed configuration, logs, screenshots, and shared URLs.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about MCP Server

cahthuranag/mcp-server is an MCP server that connects AI clients to the AllRatesToday API and central-bank rate endpoints. Its main tools retrieve live or official exchange rates, fixed-window history, multi-target or point-in-time rates, supported currencies, central-bank metadata, reference rates, and trial keys.

Install it by configuring your MCP client to launch `npx -y @allratestoday/mcp-server`. You can alternatively install the npm package globally and run `allratestoday-mcp`; both options start the stdio server for the client to manage.

No, an API key is not required for keyless operation. Without one, the server provides currency lists, central-bank metadata, selected official rates, reference rates, and supported keyless exchange-rate queries. Set `ALLRATES_API_KEY` for broader real-time mid-market and authenticated historical access.

Yes, Cursor is named as a supported MCP client. You can configure it to launch the stdio package, or use the hosted Streamable HTTP endpoint if your Cursor setup supports remote MCP connections.

Related MCP servers

All in Finance & Fintech All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewMCP Server AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/cahthuranag-mcp-server?style=directory)](https://allmcps.com/mcp/cahthuranag-mcp-server)
HTML Embed
<a href="https://allmcps.com/mcp/cahthuranag-mcp-server"><img src="https://allmcps.com/api/badge/cahthuranag-mcp-server?style=directory" alt="MCP Server on AllMCPs" /></a>