🔗 MCP Realtime API

Introduction

Use the FinFeedAPI Currencies Realtime MCP server to discover assets, fetch current pair rates, and retrieve one-to-many pricing from a single base asset.

Currencies API Realtime MCP

The FinFeedAPI Currencies Realtime API is available through a hosted Model Context Protocol (MCP) server at https://api-realtime.fx.finfeedapi.com/mcp. It exposes the current FX and crypto 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 Currencies MCP server you can:

  • Reuse the same X-APIKey authentication you already use with FinFeedAPI.
  • Let MCP-aware clients inspect tool schemas before calling the API.
  • Connect directly to a dedicated hosted endpoint instead of building your own adapter.

Use your regular FinFeedAPI API key in the X-APIKey header.

What is available through MCP?

The realtime server currently exposes 4 tools grouped into two areas:

AreaWhat you can do
Metadata discoveryList assets and fetch asset icon URLs for supported fiat and crypto assets.
Current exchange ratesRetrieve the latest rate for one pair or get current rates from one base asset to many quotes.

Typical workflows

Discover assets for the UI

  1. Call exchange_rates_list_assets to confirm valid asset_id values.
  2. Use filter_asset_id when you only need a shortlist such as BTC, USD, and EUR.
  3. Call exchange_rates_list_asset_icons to render asset pickers or watchlists.

Get realtime pricing

  1. Call exchange_rates_get_rate for a single pair such as BTC/USD.
  2. Call exchange_rates_get_all_rates when one base asset needs to be priced against many quotes.
  3. Use invert: true when the consumer expects reciprocal rates.

Live-tested notes

  • exchange_rates_get_rate returns a single object with time, asset_id_base, asset_id_quote, and rate.
  • exchange_rates_get_all_rates returns an object with asset_id_base and a nested rates array.
  • exchange_rates_list_assets can return metadata such as name, type_is_crypto, price_usd, id_icon, and chain_addresses.
  • Both exchange_rates_list_assets and exchange_rates_get_all_rates accept filter_asset_id as a comma- or semicolon-delimited list.
  • exchange_rates_list_asset_icons returns asset_id and url pairs for the requested icon size.

Start here

Getting Started

Configure an MCP client, authenticate requests, and run your first realtime exchange-rate queries.

Tool Reference

Full reference for all realtime Currencies MCP tools, parameters, workflows, and usage patterns.

Service StatusGitHub SDK

Messages

WebSocket endpoint provides real-time exchange rates streaming which works in Subscribe-Publish communication model. After establishing a WebSocket connection with us, you will need to send a Hello message documented below.

Getting Started

Connect your MCP client to the FinFeedAPI Currencies Realtime MCP server and start querying assets and current exchange rates.

On this page

Currencies API Realtime MCPWhy use MCP?What is available through MCP?Typical workflowsDiscover assets for the UIGet realtime pricingLive-tested notesStart here