Introduction
Use the CoinAPI Exchange Rates Realtime MCP server to discover assets, fetch current pair rates, and retrieve one-to-many pricing from a single base asset.
Exchange Rates Realtime MCP
The CoinAPI Exchange Rates Realtime API is available through a hosted Model Context Protocol (MCP) server. It exposes the current exchange-rates API as self-describing tools that can be used from Cursor, Claude Desktop, or custom agent runtimes.
Why use MCP?
MCP layers self-describing JSON-Schema tools over the underlying HTTP API, so agent runtimes can discover available operations, validate arguments, and call the service without a custom integration layer.
With the realtime Exchange Rates MCP server you can:
- Reuse the same
X-CoinAPI-Keyauthentication you already use with CoinAPI. - Let MCP-aware clients inspect tool schemas before calling the API.
- Connect directly to a dedicated hosted endpoint instead of building your own adapter.
Server endpoint
https://api-realtime.exrates.coinapi.io/mcpUse your regular CoinAPI API key in the X-CoinAPI-Key header.
Only the
/mcpendpoint is supported for this service.
What is available through MCP?
The realtime server currently exposes 4 tools grouped into two areas:
| Area | What you can do |
|---|---|
| Metadata discovery | List assets and fetch asset icon URLs for supported fiat and crypto assets. |
| Current exchange rates | Retrieve the latest rate for one pair or get current rates from one base asset to many quotes. |
Typical workflows
Discover assets for the UI
- Call
exchange_rates_list_assetsto confirm validasset_idvalues. - Use
filter_asset_idwhen you only need a shortlist such asBTC,USD, andEUR. - Call
exchange_rates_list_asset_iconsto render asset pickers or watchlists.
Get realtime pricing
- Call
exchange_rates_get_ratefor a single pair such asBTC/USD. - Call
exchange_rates_get_all_rateswhen one base asset needs to be priced against many quotes. - Use
invert: truewhen the consumer expects reciprocal rates.
Live-tested notes
exchange_rates_get_ratereturns a single object withtime,asset_id_base,asset_id_quote, andrate.exchange_rates_get_all_ratesreturns an object withasset_id_baseand a nestedratesarray.exchange_rates_list_assetscan return metadata such asname,type_is_crypto,price_usd,id_icon, andchain_addresses.- Both
exchange_rates_list_assetsandexchange_rates_get_all_ratesacceptfilter_asset_idas a comma- or semicolon-delimited list. exchange_rates_list_asset_iconsreturnsasset_idandurlpairs for the requested icon size.- MCP uses HTTP streaming transport, so most clients work with the standard hosted server configuration.