Use currencyapi with AI agents (MCP)
currencyapi ships a hosted Model Context Protocol (MCP) server. AI agents and assistants — Claude, Cursor, VS Code and any other MCP-capable client — can call the API as native tools, no SDK or glue code required.
https://api.currencyapi.com/mcp
Connect in seconds
Using Claude Code:
claude mcp add --transport http currencyapi https://api.currencyapi.com/mcp --header "apikey: YOUR_API_KEY"
Or add it to any MCP client configuration:
{
"mcpServers": {
"currencyapi": {
"url": "https://api.currencyapi.com/mcp",
"headers": { "apikey": "YOUR_API_KEY" }
}
}
}
With the configuration above, every request needs your API key, including the MCP handshake and listing the tools. Sign up for a free API key and send it as the apikey header.
Sign in instead of an API key
MCP clients that support sign-in (OAuth), such as Claude’s custom connectors, can sign in instead of sending a key. In Claude, open Settings → Connectors → Add custom connector and enter https://api.currencyapi.com/mcp. The client opens a sign-in page on app.currencyapi.com: sign in or sign up, and approve the connection (as the team’s owner or an admin). The client then holds a key of your team that lasts an hour and renews itself; its tool calls count against your plan like any other request. You can disconnect it at any time under API keys → Connected apps in the dashboard. For your own code, use an API key.
Available tools
| Tool | Endpoint | Description |
|---|---|---|
getLatest | GET /v3/latest | Latest exchange rates |
getHistorical | GET /v3/historical | Historical exchange rates |
getConvert | GET /v3/convert | Convert a value between currencies |
getRate | GET /v3/rate | Exchange rate of one currency pair |
getMatrix | GET /v3/matrix | Cross rates between several currencies |
getRange | GET /v3/range | Historical exchange rates for a time range |
getOhlc | GET /v3/ohlc | Hourly or daily OHLC candles |
getFluctuation | GET /v3/fluctuation | How rates changed between two dates |
getAverage | GET /v3/average | Average, low and high rates per month, quarter or year |
getOfficial | GET /v3/official | Official central bank exchange rates |
getOfficialRange | GET /v3/official/range | Official central bank exchange rates for a date range |
getOfficialCompare | GET /v3/official/compare | Compare one currency pair across central banks |
getOfficialSources | GET /v3/official/sources | List central bank sources |
getCurrencies | GET /v3/currencies | List supported currencies |
getCountries | GET /v3/countries | List countries |
getStatus | GET /v3/status | Account quota status |
Tool calls are metered like regular API requests and return the same machine-readable errors, so your agent always knows how to proceed. Full details in the MCP documentation.