`convert`

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

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

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

Parameters

Name	Type	Required	Description
`from`	string	yes	Source currency code (e.g., USD)
`to`	string	yes	Target currency code (e.g., JPY)
`amount`	number	yes	Amount to convert

Example call

Arguments

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

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":"convert","arguments":{"from":"USD","to":"EUR","amount":100}}}'

TypeScript (@pipeworx/sdk)

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

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

More examples

{
  "from": "JPY",
  "to": "CHF",
  "amount": 50000
}

Response shape

Always returns: from, to, rate, amount, converted, date

Field	Type	Description
`from`	string	Source currency code (uppercase)
`to`	string	Target currency code (uppercase)
`rate`	number	Exchange rate applied
`amount`	number	Original amount in source currency
`converted`	number	Converted amount in target currency
`date`	string	Date 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": "Exchange rate applied"
    },
    "amount": {
      "type": "number",
      "description": "Original amount in source currency"
    },
    "converted": {
      "type": "number",
      "description": "Converted amount in target currency"
    },
    "date": {
      "type": "string",
      "description": "Date of the rate (ISO format)"
    }
  },
  "required": [
    "from",
    "to",
    "rate",
    "amount",
    "converted",
    "date"
  ]
}

Connect

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

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

See Getting Started for client-specific install steps.

convert