MCP.Market

Realtime Exchange Rate MCP server

by cahthuranag·io.github.cahthuranag/realtime-exchange-rate-mcp·v0.3.3
No reviews yet

Real-time currency exchange rates, historical data, and multi-currency lookups for MCP clients.

A85/100grade A
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
A85/100

full report

Adoption
Growing

0 stars149 downloads/wk

Reviews

Write one

Nobody has reviewed Realtime Exchange Rate yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Realtime Exchange Rate tools (4)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • get_exchange_rate

    Get the current mid-market exchange rate between two currencies. Returns a single rate number. Requires API key (ALLRATES_API_KEY).

  • get_historical_rates

    Get historical exchange-rate data points for a currency pair over a period. Periods: 1d (hourly), 7d (daily), 30d (daily), 1y (weekly). Requires API key (ALLRATES_API_KEY).

  • get_rates_authenticated

    Get rates with higher limits and multi-target support. Requires API key (ALLRATES_API_KEY). Supports comma-separated targets like "EUR,GBP,JPY".

  • list_currencies

    List all supported currencies with code, name, and symbol. Requires API key (ALLRATES_API_KEY). Cached 24h upstream.

Public scan report

scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it

no findings
  • Code scan5 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitystatic API keys via environment variables6/15
  • Maintenancelast push 27 days ago15/15
  • Maintainer identityregistry namespace matches repository owner; GitHub account older than a year9/10
Overall 85/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How Realtime Exchange Rate compares

Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
85/100
higher than 70% of 48,243 servers
Tools
4
the typical server has 7
Tools that change things
0%
typical: 0%. Fewer write tools means less an agent can break
Downloads a week
149
more than 71% of 12,306 servers with a package

What its tools let an agent do: 4 read

Install Realtime Exchange Rate in Claude Code, Cursor or VS Code

Runs npx -y @allratestoday/mcp-server on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add realtime-exchange-rate-mcp -- npx -y @allratestoday/mcp-server
Add to Cursor

What the publisher says

From the Realtime Exchange Rate repository's README, as published. We do not edit it. Read it on GitHub

Realtime Exchange Rate MCP Server — @allratestoday/mcp-server

A Model Context Protocol server that lets Claude Code, Cursor, Claude Desktop, Windsurf, and any other MCP-compatible client fetch real-time currency rates, historical series, and multi-currency lookups from the AllRatesToday API. Rates come from institutional interbank market data.

English | 简体中文

After installation, your assistant can answer questions like:

  • "What's the current USD to EUR rate?"
  • "Show me how GBP/JPY moved over the last 30 days."
  • "Convert 250 USD into CAD at a real rate."
  • "Compare USD against EUR, GBP, and JPY simultaneously."
  • "List every supported currency."

🚀 Features

  • 💱 Live mid-market rates — current rate for any supported ISO 4217 pair
  • 📈 Historical series built in — 1d (hourly), 7d (daily), 30d (daily), 1y (weekly)
  • 🧰 Four focused tools — getexchangerate, gethistoricalrates, getratesauthenticated, list_currencies; a small surface the model uses correctly
  • 🔌 Works everywhere MCP does — stdio transport, MCP SDK 1.x; Claude Code, Cursor, Claude Desktop, Windsurf, or any generic stdio host
  • 🛡️ Fail-fast and honest — refuses to start without an API key and relays upstream API errors verbatim instead of guessing
  • 🔒 Nothing leaks — only the request parameters and your API key ever reach allratestoday.com; never conversation context
  • 📦 Two runtime dependencies — @modelcontextprotocol/sdk and zod; Node.js ≥ 18

Everything these tools return is a mid-market rate — the interbank midpoint, the right number for price display and conversion. It is not the official rate a tax authority or auditor may require; for published central-bank and tax-authority rates, see the AllRatesToday docs.

🔑 Get your API key

The server will not start without a valid ALLRATESAPIKEY, and all four tools require it. A free key is enough for development and personal use.

  1. Register at allratestoday.com/register
  2. Verify your email
  3. Copy your key from the dashboard (format: artlivexxxxx)
  4. Use it as ALLRATESAPIKEY in the configs below

If the key is missing, the server prints registration instructions on stderr and exits with code 1.

📦 Installation

The simplest install is zero-install via npx, which is what every config below uses:

# Run without installing (recommended)
npx -y @allratestoday/mcp-server
# Or install globally
npm install -g @allratestoday/mcp-server
allratestoday-mcp

Both commands launch the stdio MCP server and wait for a client to connect — they are not meant to be run interactively from your shell; your MCP client launches them as a subprocess.

🏁 Quick start

Each client reads MCP servers from a different config file. Pick yours below.

Claude Code

The fastest path uses the built-in CLI:

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Realtime Exchange Rate: common questions

Is Realtime Exchange Rate MCP server safe?
Yes, by our scan: it is graded A (85/100). Read the Realtime Exchange Rate safety report
How do I install Realtime Exchange Rate?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Realtime Exchange Rate need an API key?
Yes. The registry entry asks for ALLRATES_API_KEY.
Is Realtime Exchange Rate maintained?
The last commit was 66 days ago (2026-08-31). The latest release is v0.3.3.
How does Realtime Exchange Rate compare with other MCP servers?
safety score 85/100 (higher than 70% of 48,243 servers); tools 4 (the typical server has 7); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.