The official CurrencyFreaks MCP server adds 7 currency tools to Claude, Cursor, VS Code and any MCP client. Ask for a rate, a conversion or a 30-day move in plain English, and the model fetches real numbers for 1000+ fiat, crypto and metal currencies instead of guessing from its training data.
npx -y @currencyfreaks/mcpConvert 500 USD to PKR.
500 USD is 140,841.48 PKR at a rate of 281.683, as of 2026-08-25 15:22 UTC.
Works in
Any stdio MCP client
Why it exists
A language model's idea of USD to PKR is frozen at its training cutoff. Ask the same question with the MCP server connected and the answer comes from a live API call, with a timestamp you can check.
“Convert 500 USD to PKR.”
I don’t have access to live exchange rates. Based on my training data, 1 USD was roughly 278 PKR, so 500 USD would be around 139,000 PKR. Please check a financial website for the current rate.
“Convert 500 USD to PKR.”
convert_currency
500 USD is 140,841.48 PKR at a rate of 281.683, as of 2026-08-25 15:22 UTC.
Rates and amounts come back as strings, so nothing gets rounded by floating-point math between the API and the answer.
A 402 doesn't reach you as a bare status code. It carries a guidance field telling the model which plan unlocks the tool.
Your client starts the server with npx over stdio. Your key stays in your local config and only goes to api.currencyfreaks.com.
How it works
The server is a thin, typed layer over the CurrencyFreaks v2.0 REST API. It validates input before spending a request, then hands structured JSON back to the model.
“How much has the yen moved against the dollar since June 1st?”
get_fluctuation base=USD symbols=JPY
GET /v2.0/fluctuation + your apikey
Start rate, end rate and percent change, in a sentence.
Setup
Add one config block to your MCP client. There is no repo to clone and nothing to build.
get_latest_ratesOpen Settings, then Developer, then Edit Config, and add the server to claude_desktop_config.json.
{
"mcpServers": {
"currencyfreaks": {
"command": "npx",
"args": ["-y", "@currencyfreaks/mcp"],
"env": {
"CURRENCYFREAKS_API_KEY": "<YOUR_API_KEY>"
}
}
}
}Restart Claude Desktop after saving.
Tool reference
Each tool maps to one CurrencyFreaks endpoint. Currency codes are case-insensitive and symbols takes a comma-separated list like EUR,GBP,PKR.
Latest rates for one or more currencies against a base. Refresh speed follows your plan, down to every 60 seconds.
GET/v2.0/rates/latest
Convert an amount between two currencies at today's rate, or at any past date when you pass one.
GET/v2.0/convert/latest
Rates on a specific past date. Major fiat currencies go back to 1984-11-28.
GET/v2.0/rates/historical
Daily rates between two dates, one entry per day. Good for charts and month-over-month questions.
GET/v2.0/timeseries
Start rate, end rate, absolute change and percent change for each currency between two dates.
GET/v2.0/fluctuation
Finds the local currency for an IP address and converts an amount into it.
GET/v2.0/iptocurrency
Search the catalogue by code, name or country. Pass detailed=true to get each currency’s status, flag and the date range its historical data covers. It reads public endpoints, so it works before you add a key.
GET/v2.0/currency-symbols
search: "bitcoin"
detailed: true
Try it
Pick a prompt to see which tool the client calls, what the API returns and how the model phrases it. Exact wording depends on the model.
What are the latest EUR, GBP, and PKR rates against the dollar?
{
"date": "2026-08-25 13:26:00+00",
"base": "USD",
"rates": {
"EUR": "0.9278605451274349",
"GBP": "0.8172754173817152",
"PKR": "281.6212943333344",
"USD": "1.0"
}
}Assistant: As of 2026-08-25 13:26 UTC, 1 USD buys 0.9279 EUR, 0.8173 GBP, or 281.62 PKR.
More prompts to try
Click one to copy it, then paste it into your client.
Plan requirements
On the free plan the model can read latest rates against USD and search the catalogue. A call above your plan returns a 402 with guidance instead of failing silently.
| Tool | DeveloperFree · Daily refresh | StarterHourly refresh | Growth10 min refresh | Professional60 sec refresh |
|---|---|---|---|---|
| get_latest_rates | USD base on free | |||
| list_currencies | No key needed | |||
| convert_currency | ||||
| get_historical_rates | ||||
| ip_to_currency | ||||
| get_time_series | ||||
| get_fluctuation |
The base parameter needs Starter or above on every tool.
Error handling
Tool calls never crash the server. Upstream errors come back as structured results with a guidance field, so your assistant can tell you to fix the key or upgrade instead of repeating a status code.
{
"error": "Invalid Api Access Exception",
"code": 401,
"message": "Provided API key is invalid.",
"guidance": "The API key is invalid or inactive. Check CURRENCYFREAKS_API_KEY in your MCP client config and confirm the key is active on the CurrencyFreaks dashboard."
}What your assistant says
What’s the EUR rate right now?
Assistant: I couldn’t fetch rates because your CurrencyFreaks API key was rejected. Check CURRENCYFREAKS_API_KEY in your MCP client config and make sure the key is active on your dashboard.
Built from the highlighted guidance line. Exact wording depends on the model.
FAQ
Short answers on cost, setup, API keys and quota.
Didn’t find your answer?
Open an issue for bugs and feature requests, or ask our support team about your account.
MCP (Model Context Protocol) is an open standard that lets AI clients such as Claude, Cursor and VS Code call outside tools. An MCP server is the small program that exposes those tools. The CurrencyFreaks MCP server exposes 7 currency tools backed by the CurrencyFreaks v2.0 REST API.
The server is open source under the MIT license. You need a CurrencyFreaks API key, and the free Developer plan gives you 1,000 requests a month with no card. On that plan get_latest_rates (USD base) and list_currencies work. Conversion, historical data, time series, fluctuation and IP-to-currency need a paid plan.
Claude Desktop, Claude Code, Cursor, Windsurf, VS Code with GitHub Copilot, Cline and Codex CLI each have a documented setup. Any other client that runs MCP servers over stdio works with the same npx command.
The key lives in the env block of your MCP client config on your own machine. The server runs locally through npx, reads CURRENCYFREAKS_API_KEY on each call and sends it only to api.currencyfreaks.com.
Each tool call is one request to the CurrencyFreaks API and counts toward your monthly quota. A single prompt can trigger more than one tool call if the model needs several lookups. list_currencies reads public catalogue endpoints that don't need a key.
Without symbols, the rate tools return all 1000+ currencies. Ask for specific currencies, or tell the model to pass symbols, and pass search to list_currencies. The full detailed catalogue is about 270 KB.
Free API key, one config block, one restart. 1,000 requests a month on the Developer plan.