MCP Server — AllRatesToday Documentation

Connect Claude Code, Cursor, Claude Desktop, Windsurf, and any MCP-compatible client to live and historical currency exchange rate data via the AllRatesToday MCP server.

MCP Server

The @allratestoday/mcp-server package gives any Model Context Protocol client direct access to the AllRatesToday currency API. Once installed, your AI assistant can fetch live mid-market rates, query historical time-series, list supported currencies, and pull authenticated multi-target rates — without you writing any glue code.

The server is published on the official MCP registry as io.github.cahthuranag/mcp-server and on npm. The free tier (300 requests/month) is enough to evaluate it; two of the four tools work without an API key at all.

Adding MCP Servers

The server runs locally on your machine via npx — there is nothing to host and your API key never leaves your computer. Pick your client below:

• Claude Code
• Cursor
• Claude Desktop
• ChatGPT Desktop
• Windsurf
• Other MCP clients

Installation

Claude Code

Run two commands in any terminal:

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

The server is registered globally and available in every Claude Code session. Run claude mcp list to verify.

Cursor

Edit ~/.cursor/mcp.json (global) or .cursor/mcp.json in your project root, and add an entry under mcpServers:

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

Restart Cursor. The four tools appear under the MCP icon in chat.

Claude Desktop

Edit your Claude Desktop config file:

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

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

Fully quit and reopen Claude Desktop after editing — closing the window leaves it running and the new config will not load.

ChatGPT Desktop

ChatGPT Desktop reads the same JSON format. Add the block above to its MCP config and restart the app.

Windsurf

Open Windsurf settings → MCP → Add custom server. Use the same configuration block as Cursor.

Other MCP clients

Any client that supports the MCP stdio transport will work. Point it at the command:

npx -y @allratestoday/mcp-server

Pass ALLRATES_API_KEY through the environment.

Configuration

The server reads two environment variables:

Tools

The server exposes four typed tools. The MCP client introspects each tool's schema automatically and passes it to the model — you do not need to register them yourself.

Currency / Exchange Rate

• get_exchange_rate — current mid-market rate between any two of 160+ supported currencies. No API key required.
• get_rates_authenticated — fetch one base currency against multiple targets in a single call. Higher rate limits. API key required.

Historical

• get_historical_rates — time-series data over 1d, 7d, 30d, or 1y windows for any currency pair. API key required.

Discovery

• list_currencies — every supported currency code with its name, symbol, and decimal precision. Useful as a one-shot reference for the model. No API key required.

Authentication

1. Sign up at allratestoday.com/register — about thirty seconds.
2. Verify your email.
3. Copy the key from your dashboard. It begins with art_live_.
4. Set it as ALLRATES_API_KEY in your MCP client's env block (see Installation).

The free plan includes 300 requests/month. Public tools (get_exchange_rate and list_currencies) work without a key — test connectivity with those first if you run into auth issues.

Example prompts

Once installed, try:

• "What's the USD to EUR rate right now?"
• "Show me GBP/JPY over the last 30 days as a sparkline."
• "If I had 1,000 EUR and converted half to GBP and half to JPY, what would I have in USD?" — the model chains get_exchange_rate calls itself.
• "List every currency you support, sorted alphabetically."
• "Give me a 1-year time series for AUD/USD."

Troubleshooting

Resources

• Source code & issues: github.com/cahthuranag/mcp-server
• npm package: @allratestoday/mcp-server
• Official MCP registry entry: io.github.cahthuranag/mcp-server
• Feature overview: /mcp/
• Full API reference: /docs/
• Python alternative for DeepSeek: /deepseek/