convert_currencyLABSCO SUMMARY
A rate you can quote, with its source attached.
Every response says which provider it came from, when, and whether it was cached - so a converted figure in a document can be traced rather than merely trusted. Fifty targets in one call keeps a whole price list to a single round trip.
What it is
A currency and crypto rate server with failover across several upstream sources. It resolves currency names loosely, so "bitcoin" and "rupees" work as well as BTC and INR, and every answer carries the rate, its inverse, the source that answered and whether it came from cache.
What you get
- Any fiat or crypto pair converted, with the rate, the inverse rate, a timestamp and the source named
- One amount converted into many targets in a single call, with duplicates and same-as-source entries filtered out
- Current rates for a base currency against multiple targets
- A rate as it stood on a past date
- Currency names resolved loosely, so plain words work as well as ISO codes
- Failover across sources, and a cache flag on every response so you know whether the number is fresh
Requirements
For the hosted Actor, an Apify account and API token, sent as an Authorization: Bearer header; Apify bills per call. Running it yourself needs a recent Node and no token: clone, then npm install && npm run start:dev serves it at http://localhost:3000/mcp. The upstream rate sources need no keys either way, and each response names which one answered.
Setup effort
Add the hosted endpoint plus a key — paste it into your client, then supply credentials
USE CASES
01
Quoting a price in the customer's currency
Convert the amount and keep the rate, the inverse and the timestamp with it, so the quote can be reproduced later.
02
Pricing a list for every market at once
Send one amount and up to fifty target currencies in a single call rather than looping.
03
Checking what a figure was worth at the time
Look the rate up for the date the transaction happened, not for today.
04
Watching one currency against a basket
Ask for current rates for a base against the targets you care about, in one response.
05
Asking in plain words
"A thousand dollars in rupees" resolves without you looking up the ISO codes first.
4 tools
Listed in project docs. Your client may show a different list.
batch_convertget_exchange_ratesget_historical_rateBEFORE YOU INSTALL
What to know first
Tools you get
4 tools named in the project's documentation.
Requires
A client that can reach a remote MCP server over HTTP
Where it runs
Both documented clients connect to a hosted endpoint.
INSTALLATION
Connect your client
Server setup
From source
TERMINAL
git clone https://github.com/Ruddxxy/currency-exchange-mcp.git
cd currency-exchange-mcp
npm install && npm run start:devHosted endpoint
ENDPOINT URL
https://vector384--currency-exchange-mcp.apify.actor/mcpAdd this hosted endpoint to your MCP client using the credentials listed under Requirements.
MCP Clients
Cline
CLINE · JSON
{
"mcpServers": {
"currency-exchange": {
"type": "streamableHttp",
"url": "https://vector384--currency-exchange-mcp.apify.actor/mcp",
"headers": {
"Authorization": "Bearer <YOUR_APIFY_API_TOKEN>"
}
}
}
}Cursor
CURSOR · JSON
{
"mcpServers": {
"currency-exchange": {
"url": "https://vector384--currency-exchange-mcp.apify.actor/mcp",
"headers": {
"Authorization": "Bearer <YOUR_APIFY_API_TOKEN>"
}
}
}
}
