AllRatesToday Currency API

MCP server: allratestoday

# Cursor Directory listing update — v0.3.0

This file contains paste-ready copy for updating the Cursor Directory listing
at https://cursor.directory/plugins/allratestoday-currency-api after publishing
v0.3.0 of the MCP server.

You'll need to log in to cursor.directory with the account that owns the listing,
then edit the description and configuration JSON.

---

## Short description (one-liner, top of listing)

```
Real-time currency exchange rates, historical data, and 150+ currencies for AI agents. Free API key required (300 requests/month, no credit card).
```

## Long description / "About"

```
AllRatesToday MCP Server gives Cursor (and any other MCP-compatible client) live access to mid-market foreign exchange rates and historical data sourced from tier-one financial data providers.

Once installed, your AI agent can answer questions like:
• "What's the current USD to EUR rate?"
• "Show me the GBP/JPY trend over the last 30 days."
• "Convert 250 USD into CAD using a real rate."
• "List every supported currency."

## Features

• Live mid-market rates for 150+ ISO 4217 currencies
• Historical data with 1d / 7d / 30d / 1y granularity
• Multi-target queries — fetch USD→EUR, GBP, JPY in one call
• Currency metadata (codes, names, symbols, country flags)
• 4 MCP tools: get_exchange_rate, get_historical_rates, get_rates_authenticated, list_currencies

## Setup (2 minutes)

1. Sign up free at https://allratestoday.com/register — takes 30 seconds, no card required, includes 300 requests/month
2. Copy your API key from the dashboard
3. Add the server to your Cursor config (see Configuration tab)
4. Restart Cursor

## Plans

• Free — 300 requests/month, current rates, basic historical
• Small — €4.99/mo, 5,000 requests
• Medium — €9.99/mo, 10,000 requests
• Large — €49.99/mo, 100,000 requests

Full pricing: https://allratestoday.com/pricing
```

## Configuration JSON (paste into the Cursor Directory's "Setup" or "Config" field)

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

## Setup instructions (paste into the Cursor Directory's "How to install" section)

```
Required: AllRatesToday API key (free at https://allratestoday.com/register).

1. Sign up at allratestoday.com/register — takes 30 seconds, no credit card
2. Copy your API key (format: art_live_xxxxx) from your dashboard
3. Open ~/.cursor/mcp.json (or your project's .cursor/mcp.json)
4. Paste the configuration above, replacing "art_live_xxxxx" with your real key
5. Restart Cursor

The server will refuse to start without an API key and print registration instructions in the console if you forget.

Verified working with Cursor 0.40+.
```

## Tags / Keywords

```
currency, exchange-rate, forex, fx, finance, mcp, anthropic, claude, cursor,
real-time, historical, rates, trading, api, allratestoday
```

## What's new in v0.3.0 (changelog field, if available)

```
v0.3.0 (breaking change)
- API key is now required for all four tools (previously, get_exchange_rate
  and list_currencies worked without one)
- Server fails fast at startup with clear registration instructions if
  ALLRATES_API_KEY is not set
- Bumped npm package version

Why: aligns with how the AllRatesToday backend handles rate limits and quotas.
The free tier (300 requests/month) is still enough for development and
personal use.

Migration: existing users on v0.2.0 just need to set ALLRATES_API_KEY in their
MCP config. Sign up at https://allratestoday.com/register if you don't have
one yet.
```

## Image / hero asset

The Cursor Directory listing currently uses your favicon. If you want to upload
a richer card image, the recommended size is 600×400 PNG. A simple option:
green background (#25A557), white "AllRatesToday" wordmark, small currency-pair
illustration.

---

## Don't forget

After updating the Cursor Directory listing, also update:

- **Pulse MCP listing** at https://www.pulsemcp.com/servers/cahthuranag-allratestoday — same description content
- **GitHub repo description** at https://github.com/cahthuranag/mcp-server — change the "About" section to mention "API key required"
- **npm package readme** is auto-pulled from `README.md` (already updated)
- **MCP registry** (`mcp-registry.json` or equivalent if you've registered it there)