Currencies Realtime MCP Tool Reference

The realtime server currently exposes 4 tools.

Metadata tools

exchange_rates_list_assets

Returns supported assets, including fiat currencies and cryptocurrencies.

Optional arguments

Returns

Each item can include fields such as:

• asset_id
• name
• type_is_crypto
• price_usd
• id_icon
• chain_addresses

Use when

• You need to validate asset identifiers before requesting rates.
• You want asset metadata for selectors, forms, or reference datasets.

exchange_rates_list_asset_icons

Returns icon URLs for assets at a chosen pixel size.

Required arguments

Returns

Rows include:

• asset_id
• url

Use when

• You need a consistent icon set for asset selectors, watchlists, or dashboards.

Current rate tools

exchange_rates_get_rate

Returns the current exchange rate for one base/quote pair.

Required arguments

Returns

A single object with:

• time
• asset_id_base
• asset_id_quote
• rate

Use when

• You need the latest conversion for one pair.
• You are refreshing a single ticker, quote card, or valuation widget.

exchange_rates_get_all_rates

Returns current rates from one base asset to many quote assets.

Required arguments

Optional arguments

Returns

An object with:

• asset_id_base
• rates[]

Each rates[] item includes:

• time
• asset_id_quote
• rate

Use when

• You want one base asset quoted in several currencies.
• You need fewer round trips than calling exchange_rates_get_rate repeatedly.

Practical examples

Example: current BTC/USD rate

{
  "tool": "exchange_rates_get_rate",
  "arguments": {
    "asset_id_base": "BTC",
    "asset_id_quote": "USD"
  }
}

Example: current BTC rates against three quotes

{
  "tool": "exchange_rates_get_all_rates",
  "arguments": {
    "asset_id_base": "BTC",
    "filter_asset_id": "USD;EUR;GBP"
  }
}

Example: 32px asset icons

{
  "tool": "exchange_rates_list_asset_icons",
  "arguments": {
    "size": 32
  }
}

Usage guidance

• Start with exchange_rates_list_assets when the client allows users to type or select asset codes.
• Use exchange_rates_get_rate for one conversion and exchange_rates_get_all_rates for one-to-many fan-out pricing.
• Apply filter_asset_id whenever the consumer only needs a shortlist, especially for UI-oriented requests.
• Cache asset metadata and icon payloads client-side because these lists change much less often than pricing.