AllRatesToday MCP Server — Currency Rates in Claude Code & Cursor

Give Claude Code, Cursor, and Claude Desktop access to real-time currency exchange rates. Install @allratestoday/mcp-server in one line and let your AI assistant convert and compare currencies.

AllRatesToday now ships a Model Context Protocol (MCP) server — a tiny bridge that gives AI coding tools like Claude Code, Cursor, and Claude Desktop direct access to real-time mid-market exchange rates and historical data.

Once configured, your AI assistant can answer questions like:

• "What's the current USD to EUR rate?"
• "Show me GBP/JPY over the last 30 days."
• "Convert 250 USD to CAD using a real rate."
• "List every supported currency."

Install

Hosted endpoint — nothing to install

The same nine tools (live rates and official central-bank rates) run as a hosted Streamable HTTP server. Paste one URL into any client that supports remote MCP — Claude.ai, Claude Desktop, ChatGPT, Cursor, VS Code, Claude Code, Codex, Gemini CLI. Works with no API key; add one for real-time rates and history.

https://allratestoday.com/api/mcp

Add to Cursor Add to VS Code

• Claude.ai / Claude Desktop: Settings → Connectors → Add custom connector → paste the URL.
• ChatGPT: Settings → Connectors → Create (developer mode) → paste the URL, authentication None.
• Claude Code: claude mcp add --transport http allratestoday https://allratestoday.com/api/mcp
• Cursor / Windsurf / Claude Desktop JSON: { "mcpServers": { "allratestoday": { "url": "https://allratestoday.com/api/mcp" } } }
• Codex CLI (~/.codex/config.toml): [mcp_servers.allratestoday] then url = "https://allratestoday.com/api/mcp"
• Gemini CLI (settings.json): { "mcpServers": { "allratestoday": { "httpUrl": "https://allratestoday.com/api/mcp" } } }

With an API key: send Authorization: Bearer art_live_…, or — for clients that only take a URL — connect to https://allratestoday.com/api/mcp?api_key=art_live_…. The endpoint is stateless and every call is metered exactly like the REST API. Prefer a local process? The npm servers below expose the identical tools over stdio.

Claude Code — the plugin (recommended for Claude Code)

One plugin installs both MCP servers (live rates and official central-bank rates), two skills that load themselves when a task involves currency, and five slash commands. No API key needed to start.

/plugin marketplace add AllRates-Today/claude-code-plugin
/plugin install allratestoday@allratestoday

Then: /rate USD EUR, /convert 1500 USD to EUR, /official-rate ecb USD EUR 2026-01-15, /fx-history USD EUR 30d, /add-currency-support.

Claude Code — the MCP server alone

claude mcp add allratestoday -- npx -y @allratestoday/mcp-server
claude mcp env allratestoday ALLRATES_API_KEY=art_live_xxxxx

The key is optional: without one the server still answers get_exchange_rate from the official ECB daily reference table and list_currencies in full.

Cursor

Edit ~/.cursor/mcp.json (or project .cursor/mcp.json):

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

Claude Desktop

Edit your Claude Desktop config file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

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

Restart the app after editing.

Tools exposed

Get an API key

1. Register at allratestoday.com/register.
2. Verify your email.
3. Copy your key from the dashboard — it looks like art_live_xxxxx.

The free plan covers personal/dev use. Two tools (get_exchange_rate and list_currencies) don't need a key. Set ALLRATES_API_KEY for the historical and multi-target endpoints.

Environment variables

FAQ

What is MCP?

Model Context Protocol is Anthropic's open standard for connecting AI assistants to external tools and data. An MCP server exposes a set of typed tools; clients like Claude Code and Cursor call them on your behalf when the model needs them.

Is the MCP server free?

The MCP server itself is MIT-licensed. The underlying API has a free tier and paid plans from €4.99/mo. Public tools work without a key.

Does it work offline?

No — the tools call the AllRatesToday API over HTTPS. Cache your results locally if you need offline behaviour.

Can I contribute?

Yes. Source is on GitHub — issues and PRs welcome.

Related