# Exchange Rate API

Real-time and historical exchange rates for 160 fiat, crypto, and precious metal currencies. Hourly updates from ECB, FloatRates, and CoinGecko. Free base switching, time-series, batch conversion, an…

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add nimbusapi/exchange-rate

# Browse available tools
npx -y @smithery/cli@latest tool list nimbusapi/exchange-rate

# Get full schema for a tool
npx -y @smithery/cli@latest tool get nimbusapi/exchange-rate get_latest_rates

# Call a tool
npx -y @smithery/cli@latest tool call nimbusapi/exchange-rate get_latest_rates '{}'
```

## Direct MCP Connection

Endpoint: `https://exchange-rate--nimbusapi.run.tools`

**Required config:**
- `apiKey` (header) — Your API key (starts with sk_live_ or sk_test_)

## Tools (6)

- `get_latest_rates` — Get the latest exchange rates for all or specific currencies. Supports any base currency (e.g. USD, EUR, BTC) and optio…
- `list_currencies` — List all 160 supported currencies with metadata: code, name, symbol, flag emoji, decimal places, and type (fiat, crypto…
- `get_historical_rates` — Get exchange rates for a specific historical date (format: YYYY-MM-DD). Data available back to 1999 for fiat currencies…
- `convert_currency` — Convert a specific amount from one currency to another using the latest or historical exchange rates. Returns the conve…
- `get_timeseries` — Get daily exchange rates over a date range (start_date to end_date, YYYY-MM-DD, max 365 days). Returns an array of dail…
- `batch_convert` — Convert multiple currency pairs in a single request. Submit up to 100 conversion pairs (from, to, amount) and get all r…

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get nimbusapi/exchange-rate <tool-name>
```

## Resources

- `exchange-rate://currencies` — List of all 160 supported currency codes, names, symbols, and types

## Prompts (2)

- `convert_currency` (amount, from, to) — Convert an amount between two currencies
- `compare_rates` (base, target, start_date, end_date) — Compare exchange rates for a currency pair over a date range