--- title: "AllRatesToday MCP Server — Currency Rates in Claude Code & Cursor" description: "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." canonical: https://allratestoday.com/mcp/ source: AllRatesToday (https://allratestoday.com/) — Markdown mirror of the page above; index of all pages at https://allratestoday.com/llms.txt generated: 2026-10-19T09:57:17.205Z --- # 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. By [Madhushan](https://allratestoday.com/authors/madhushan/), Founder & Lead Developer 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."* Works with any MCP-compatible client. Package: [`@allratestoday/mcp-server`](https://www.npmjs.com/package/@allratestoday/mcp-server). Source: [github.com/AllRates-Today/mcp-server](https://github.com/AllRates-Today/mcp-server). ## 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](cursor://anysphere.cursor-deeplink/mcp/install?name=allratestoday&config=eyJ1cmwiOiJodHRwczovL2FsbHJhdGVzdG9kYXkuY29tL2FwaS9tY3AifQ==) [Add to VS Code](vscode:mcp/install?%7B%22name%22%3A%22allratestoday%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fallratestoday.com%2Fapi%2Fmcp%22%7D) - **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 | Tool | API key | What it does | | --- | --- | --- | | `get_exchange_rate` | no | Current mid-market rate between two currencies. | | `get_historical_rates` | yes | Data points over `1d`, `7d`, `30d`, or `1y`. | | `get_rates_authenticated` | yes | Multi-target rates and higher limits. | | `list_currencies` | no | All supported currencies with codes and symbols. | | `list_central_banks` | no | Every covered central bank and tax authority, with latest publication date. *Hosted endpoint and central-bank server.* | | `get_official_rates` | latest: no · dated: yes | A named institution's official published table or pair. | | `get_official_rate_history` | yes (paid) | Date-by-date official series for one bank. | | `compare_official_rates` | yes | One pair across every bank with spread stats. | | `get_publication_calendar` | yes | Dates a bank actually published. | ## Get an API key 1. Register at [allratestoday.com/register](https://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 | Variable | Default | Purpose | | --- | --- | --- | | `ALLRATES_API_KEY` | — | Your AllRatesToday key. | | `ALLRATES_BASE_URL` | `https://allratestoday.com/api` | Override for self-hosted or staging environments. | ## 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](https://github.com/AllRates-Today/mcp-server) — issues and PRs welcome. ## Connect your AI to real currency data Install the MCP server in one line. Free tier available. [Get free API key](https://allratestoday.com/register) [View on GitHub](https://github.com/AllRates-Today/mcp-server) ## Related [MCP server documentationFull setup guide for every client](https://allratestoday.com/docs/mcp-server/) [For AI agentsTool definitions for OpenAI, Vercel AI SDK & LangChain](https://allratestoday.com/for-ai-agents/) [DeepSeek integrationPython package for DeepSeek agents](https://allratestoday.com/deepseek/) [Forex API for developersREST endpoint reference](https://allratestoday.com/use-cases/forex-api-for-developers/) [Developer docsFull API documentation](https://allratestoday.com/developers) [PricingPlans and limits](https://allratestoday.com/pricing)