`get_rates`

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

Get current exchange rates for a base currency (e.g., ‘USD’, ‘EUR’). Returns conversion rates for all major currencies. Use when you need multiple rates at once.

Parameters

Name	Type	Required	Description
`base_currency`	string	yes	ISO 4217 currency code to use as the base (e.g., “USD”, “EUR”, “GBP”)

Example call

Arguments

{
  "base_currency": "USD"
}

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_rates","arguments":{"base_currency":"USD"}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('get_rates', {
  "base_currency": "USD"
});

More examples

{
  "base_currency": "EUR"
}

Response shape

Always returns: base, last_updated, next_update, rate_count, rates

Field	Type	Description
`base`	string	Base currency code
`last_updated`	string	Time of last update in UTC
`next_update`	string	Time of next update in UTC
`rate_count`	integer	Number of exchange rates returned
`rates`	object	Map of currency codes to exchange rates

Full JSON Schema

{
  "type": "object",
  "properties": {
    "base": {
      "type": "string",
      "description": "Base currency code"
    },
    "last_updated": {
      "type": "string",
      "description": "Time of last update in UTC"
    },
    "next_update": {
      "type": "string",
      "description": "Time of next update in UTC"
    },
    "rate_count": {
      "type": "integer",
      "description": "Number of exchange rates returned"
    },
    "rates": {
      "type": "object",
      "description": "Map of currency codes to exchange rates",
      "additionalProperties": {
        "type": "number"
      }
    }
  },
  "required": [
    "base",
    "last_updated",
    "next_update",
    "rate_count",
    "rates"
  ]
}

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_rates