`get_pair`

Pack: exchangerate · Endpoint: https://gateway.pipeworx.io/exchangerate/mcp

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

Get the current exchange rate between two specific currencies (e.g., USD to EUR). Returns the conversion rate. Use for single currency pair lookups.

Parameters

Name	Type	Required	Description
`from`	string	yes	Source currency code (e.g., “USD”)
`to`	string	yes	Target currency code (e.g., “JPY”)

Example call

Arguments

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

curl

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

TypeScript (@pipeworx/sdk)

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

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

More examples

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

Response shape

Always returns: from, to, rate, last_updated

Field	Type	Description
`from`	string	Source currency code
`to`	string	Target currency code
`rate`	number	Exchange rate from source to target currency
`last_updated`	string	Time of last update in UTC

Full JSON Schema

{
  "type": "object",
  "properties": {
    "from": {
      "type": "string",
      "description": "Source currency code"
    },
    "to": {
      "type": "string",
      "description": "Target currency code"
    },
    "rate": {
      "type": "number",
      "description": "Exchange rate from source to target currency"
    },
    "last_updated": {
      "type": "string",
      "description": "Time of last update in UTC"
    }
  },
  "required": [
    "from",
    "to",
    "rate",
    "last_updated"
  ]
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "exchangerate": {
      "url": "https://gateway.pipeworx.io/exchangerate/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

get_pair