get_rate

Pack: exchange · Connect: https://pipeworx.io/mcp (see Connect below for a single-pack URL)

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/get_rate for the schema, then POST the same URL with its arguments for the data.

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

Parameters

NameTypeRequiredDescription
fromstringyesSource currency code (e.g., USD, EUR, GBP)
tostringyesTarget currency code (e.g., EUR, JPY, CHF)

Example call

Arguments

{
  "from": "USD",
  "to": "EUR"
}

curl

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

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('get_rate', {
  "from": "USD",
  "to": "EUR"
});

More examples

{
  "from": "GBP",
  "to": "JPY"
}

Response shape

Always returns: from, to, rate, date

FieldTypeDescription
fromstringSource currency code (uppercase)
tostringTarget currency code (uppercase)
ratenumberCurrent exchange rate
datestringDate of the rate (ISO format)
Full JSON Schema
{
  "type": "object",
  "properties": {
    "from": {
      "type": "string",
      "description": "Source currency code (uppercase)"
    },
    "to": {
      "type": "string",
      "description": "Target currency code (uppercase)"
    },
    "rate": {
      "type": "number",
      "description": "Current exchange rate"
    },
    "date": {
      "type": "string",
      "description": "Date of the rate (ISO format)"
    }
  },
  "required": [
    "from",
    "to",
    "rate",
    "date"
  ]
}

Connect

Add this to your MCP client config — every tool in the catalog, including this one — or use one-click install buttons:

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://pipeworx.io/mcp"
    }
  }
}
Connect to just the exchange pack
{
  "mcpServers": {
    "exchange": {
      "url": "https://gateway.pipeworx.io/exchange/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

Regenerated from source · build October 30, 2026