# CurrencyScoop — how to use (mcp.ai)

Connect your CurrencyScoop account and use 5 tools for developer tools straight from your AI agent. Connect with your own API key. CurrencyBeacon is a developer friendly, easy-to-use REST API with real-time and historical exchange rates for fiat currencies and cryptocurrencies.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_currencyscoop?ms=1787291400000`
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. `currencyscoop_convert_currency2`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/currencyscoop`
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/currencyscoop/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/currencyscoop/convert/currency2` — Tool to convert any amount from one currency to another using real-time or historical exchange rates. Use when you need to convert a specific amount between two currencies, optionally specifying a dat
  - body: { to: string, date?: string, from: string, amount: integer|number }
- `POST https://api.mcp.ai/api/currencyscoop/get/currencies` — Tool to retrieve all supported currencies including their names and countries. Use when you need information about available currencies, either fiat or crypto.
  - body: { type: string }
- `POST https://api.mcp.ai/api/currencyscoop/get/historical/rates` — Tool to retrieve historical exchange rate data for past dates going back to 1996. Use when you need to access exchange rates for a specific historical date with a base currency.
  - body: { base: string, date: string, symbols?: string }
- `POST https://api.mcp.ai/api/currencyscoop/get/latest/rates` — Tool to retrieve real-time exchange rate data for all available currencies. Use when you need current exchange rates updated based on subscription plan frequency (e.g., every 60 seconds). Returns only
  - body: { base?: string, symbols?: string }
- `POST https://api.mcp.ai/api/currencyscoop/get/timeseries/rates` — Tool to retrieve historical exchange rates for a given time period between start and end dates. Use when you need exchange rates for multiple dates in a date range for trend analysis or historical com
  - body: { base: string, symbols?: string, end_date: string, start_date: string }

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

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