Exchange Rates

liveFinanceEconomics

Currency exchange rates, conversion, and historical rates from Frankfurter

4tools
0msauth
free tier50 calls/day

Tools

get_raterequired: from, to

Get the current exchange rate between two currencies (e.g., USD, EUR). Returns the rate value and timestamp.

Parameters
NameTypeDescription
fromreqstringSource currency (e.g., USD)
toreqstringTarget currency (e.g., EUR)
▶Try it
convertrequired: from, to, amount

Convert an amount from one currency to another at current rates. Returns the converted amount and the exchange rate applied.

Parameters
NameTypeDescription
fromreqstringSource currency
toreqstringTarget currency
amountreqnumberAmount to convert
▶Try it
get_historical_raterequired: from, to, date

Get the exchange rate between two currencies on a specific date (format: YYYY-MM-DD). Returns the historical rate and date.

Parameters
NameTypeDescription
fromreqstringSource currency
toreqstringTarget currency
datereqstringDate (YYYY-MM-DD)
▶Try it
get_currencies

List all supported currencies with codes and full names. Use to verify currency codes before converting or checking rates.

No parameters required.

▶Try it

Test with curl

The gateway speaks JSON-RPC 2.0 over HTTP POST. You can test any pack directly from the terminal.

List available tools
bash
curl -X POST https://gateway.pipeworx.io/exchange/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
Call a tool
bash
curl -X POST https://gateway.pipeworx.io/exchange/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"get_rate","arguments":{"from": "USD", "to": "EUR"}}}'

Use with the SDK

Install @pipeworx/sdk to call tools from any TypeScript/Node project.

TypeScript
import { Pipeworx } from '@pipeworx/sdk';
const px = new Pipeworx();
const result = await px.call("get_rate", {"from":"example","to":"example"});
ask_pipeworx
// Or ask in plain English:
const answer = await px.ask("currency exchange rates, conversion, and historical rates from frankfurter");