# Fixer.io — how to use (mcp.ai)

Connect your Fixer.io account and use 5 tools for developer tools straight from your AI agent. Connect with your own API key. Fixer.io is a simple and lightweight API for current and historical foreign exchange rates and currency conversion.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_fixer_io?ms=1787291280000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `fixer_io_convert_currency`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/fixer_io`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/fixer_io/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/fixer_io/convert/currency` — Tool to convert an amount from one currency to another. Use when you need current or historical exchange rates. Specify `date` for historical rates.
  - body: { date?: string, amount: number, to_currency: string, from_currency: string }
- `POST https://api.mcp.ai/api/fixer_io/get/fluctuation` — Tool to fetch exchange rate fluctuations between two dates. Use when you need day-to-day currency rate changes.
  - body: { base?: string, symbols?: string, end_date: string, start_date: string }
- `POST https://api.mcp.ai/api/fixer_io/get/historical/rates` — Fetch historical exchange rates for a specific date. Returns end-of-day (EOD) exchange rates for any date back to January 1, 1999. Use this when you need past currency conversion rates or historical f
  - body: { base?: string, date: string, symbols?: string }
- `POST https://api.mcp.ai/api/fixer_io/get/supported/symbols` — Tool to retrieve the list of all available currency symbols and their corresponding names. Use when you need to fetch and display supported currency codes.
  - body: { callback?: string }
- `POST https://api.mcp.ai/api/fixer_io/get/time/series` — Retrieves daily foreign exchange rates for a date range. Returns a time series of exchange rates for each day between start_date and end_date (inclusive, max 365 days). The rates show how much of each
  - body: { base?: string, symbols?: string, end_date: string, start_date: string }

## Example prompts
- "What can I do in Fixer.io?"
- "Show me a summary of my Fixer.io account"

## More
- Page: https://mcp.ai/fixer_io
- Agent spec (llms.txt): https://mcp.ai/fixer_io/llms.txt
- Postman collection: https://mcp.ai/fixer_io/postman.json
