Skip to main content
Glama

Convert currency

convert
Read-only

Convert money using a reference rate. Returns {amount,currency}, rounded to the target's minor units (8 significant figures for metals/crypto). Set details for the rate and effective date too; identity conversions have rate 1 and date null.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "amount": "<amount>",
      "from": "<from>",
      "to": "<to>"
    },
    "name": "convert"
  }
}

Input Schema

NameRequiredDescriptionDefault
toYesTarget currency or asset code.
dateNoDate YYYY-MM-DD for a past rate; omit for latest.
fromYesSource currency or asset code, e.g. USD, XAU or BTC.
amountYesNumeric amount in the source currency; normalize localized input first.
detailsNoInclude rate, effective date and provider if selected. Default false.
providerNoProvider or dataset key, e.g. ECB or NBP.B; omit for blended rates.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changed
    • changedInput schema / properties / provider / description
      Previous value: -"Institution's key, e.g. ECB or UST; omit for blended rates."New value: +"Provider or dataset key, e.g. ECB or NBP.B; omit for blended rates."
    • changedInput schema / properties / provider / maxLength
      Previous value: -8New value: +16
  2. Changed4 schema fields changed
    • changedInput schema / properties / amount / description
      Previous value: -"Amount in the source currency. Normalize localized input first: '100,50' -> 100.5; German '1.000,50' -> 1000.5; English '1,000.50' -> 1000.5."New value: +"Numeric amount in the source currency; normalize localized input first."
    • addedInput schema / properties / details
      Added value: +{
      +  "description": "Include rate, effective date and provider if selected. Default false.",
      +  "type": "boolean"
      +}
    • changedInput schema / properties / from / description
      Previous value: -"Source currency or asset code, e.g. USD, XAU or BTC. Call list_currencies if unsure."New value: +"Source currency or asset code, e.g. USD, XAU or BTC."
    • changedInput schema / properties / provider / description
      Previous value: -"Provider key, e.g. ECB for European Central Bank or UST for U.S. Treasury reporting rates. Serves that institution's published rates instead of the blend; a date inside a weekly, monthly or quarterly provider's period returns the rate in force. Keys at https://frankfurter.dev/providers/."New value: +"Institution's key, e.g. ECB or UST; omit for blended rates."
  3. Changed1 schema field changed
    • changedInput schema / properties / from / description
      Previous value: -"Source currency or asset code, e.g. USD, XAU or BTC."New value: +"Source currency or asset code, e.g. USD, XAU or BTC. Call list_currencies if unsure."
  4. Changed8 schema fields changed
    • changedInput schema / properties / from / description
      Previous value: -"ISO 4217 source currency."New value: +"Source currency or asset code, e.g. USD, XAU or BTC."
    • removedInput schema / properties / from / maxLength
      Removed value: -3
    • removedInput schema / properties / from / minLength
      Removed value: -3
    • addedInput schema / properties / from / pattern
      Added value: +"^[A-Za-z0-9]{3,5}$"
    • changedInput schema / properties / to / description
      Previous value: -"ISO 4217 target currency."New value: +"Target currency or asset code."
    • removedInput schema / properties / to / maxLength
      Removed value: -3
    • removedInput schema / properties / to / minLength
      Removed value: -3
    • addedInput schema / properties / to / pattern
      Added value: +"^[A-Za-z0-9]{3,5}$"
  5. Changed1 schema field changed
    • changedInput schema / properties / provider / description
      Previous value: -"Provider key, e.g. ECB for European Central Bank or UST for U.S. Treasury reporting rates. Serves that institution's published rates instead of the blend; a date inside a monthly or quarterly provider's period returns the rate in force. Keys at https://frankfurter.dev/providers/."New value: +"Provider key, e.g. ECB for European Central Bank or UST for U.S. Treasury reporting rates. Serves that institution's published rates instead of the blend; a date inside a weekly, monthly or quarterly provider's period returns the rate in force. Keys at https://frankfurter.dev/providers/."
  6. Changed1 schema field changed
    • changedInput schema / properties / provider / description
      Previous value: -"Provider key, e.g. UST for U.S. Treasury reporting rates. Serves that institution's published rates instead of the blend; a date inside a monthly or quarterly provider's period returns the rate in force. Keys at https://frankfurter.dev/providers/."New value: +"Provider key, e.g. ECB for European Central Bank or UST for U.S. Treasury reporting rates. Serves that institution's published rates instead of the blend; a date inside a monthly or quarterly provider's period returns the rate in force. Keys at https://frankfurter.dev/providers/."
  7. Changed1 schema field changed
    • addedInput schema / properties / provider
      Added value: +{
      +  "description": "Provider key, e.g. UST for U.S. Treasury reporting rates. Serves that institution's published rates instead of the blend; a date inside a monthly or quarterly provider's period returns the rate in force. Keys at https://frankfurter.dev/providers/.",
      +  "maxLength": 8,
      +  "minLength": 2,
      +  "type": "string"
      +}
  8. Changed2 schema fields changed
    • changedInput schema / properties / amount / description
      Previous value: -"Amount in the source currency."New value: +"Amount in the source currency. Normalize localized input first: '100,50' -> 100.5; German '1.000,50' -> 1000.5; English '1,000.50' -> 1000.5."
    • changedInput schema / properties / date / description
      Previous value: -"Historical date YYYY-MM-DD. Omit for latest."New value: +"Date YYYY-MM-DD for a past rate; omit for latest."
  9. First observed

TDQS

Score is being calculated.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.