Getting Started with Currencies Realtime MCP

This guide shows how to connect an MCP client to the hosted FinFeedAPI Currencies Realtime MCP server.

Endpoint and authentication

• MCP endpoint: https://api-realtime.fx.finfeedapi.com/mcp
• Header: X-APIKey: YOUR_API_KEY
• Transport: HTTP streaming MCP

Cursor example

Add the Currencies Realtime server to your MCP client configuration:

{
  "mcpServers": {
    "FinFeedAPI-Currencies-Realtime": {
      "url": "https://api-realtime.fx.finfeedapi.com/mcp",
      "headers": {
        "X-APIKey": "YOUR_API_KEY_HERE"
      }
    }
  }
}

Replace YOUR_API_KEY_HERE with your real API key and restart the client if required by your MCP application.

First requests to try

1. List a few assets

Call exchange_rates_list_assets with:

{
  "filter_asset_id": "BTC;USD;EUR"
}

Example response excerpt:

[
  {
    "asset_id": "USD",
    "name": "US Dollar",
    "type_is_crypto": 0
  },
  {
    "asset_id": "EUR",
    "name": "Euro",
    "type_is_crypto": 0,
    "price_usd": 1.1558625
  },
  {
    "asset_id": "BTC",
    "name": "Bitcoin",
    "type_is_crypto": 1,
    "price_usd": 68302.0600822358
  }
]

2. Fetch the current BTC/USD rate

Call exchange_rates_get_rate with:

{
  "asset_id_base": "BTC",
  "asset_id_quote": "USD"
}

Example response:

{
  "time": "2026-04-07T13:45:49.1",
  "asset_id_base": "BTC",
  "asset_id_quote": "USD",
  "rate": 68302.0600822358
}

3. Fetch current BTC rates against multiple quotes

Call exchange_rates_get_all_rates with:

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

Example response excerpt:

{
  "asset_id_base": "BTC",
  "rates": [
    {
      "time": "2026-04-07T13:45:49.6",
      "asset_id_quote": "EUR",
      "rate": 59091.85572006688
    },
    {
      "time": "2026-04-07T13:45:49.1",
      "asset_id_quote": "USD",
      "rate": 68302.0600822358
    }
  ]
}

4. Retrieve icon URLs

Call exchange_rates_list_asset_icons with:

{
  "size": 32
}

Example response excerpt:

[
  {
    "asset_id": "TMN",
    "url": "https://s3.eu-central-1.amazonaws.com/bbxt-static-icons/type-id/png_32/e08e3ef432e64c3aa7917cdeaa8256b2.png"
  },
  {
    "asset_id": "XRP",
    "url": "https://s3.eu-central-1.amazonaws.com/bbxt-static-icons/type-id/png_32/ba90bcb0cafb4801ac5dd310f47d6411.png"
  }
]

Recommended workflows

Realtime conversion workflow

1. Call exchange_rates_list_assets.
2. Pick asset_id_base and asset_id_quote.
3. Call exchange_rates_get_rate for single-pair conversion.

Realtime multi-quote workflow

1. Pick one base asset such as BTC.
2. Use exchange_rates_get_all_rates with filter_asset_id for the quote currencies you need.
3. Cache the returned payload briefly if your application renders several widgets from the same response.

Troubleshooting

No tools appear in the client

• Verify the endpoint URL is exactly https://api-realtime.fx.finfeedapi.com/mcp.
• Confirm the request includes the X-APIKey header.
• Restart the MCP client after editing its configuration.

Pair lookup fails

• Confirm both asset identifiers exist in exchange_rates_list_assets.
• Use uppercase identifiers such as BTC, USD, or EUR.

Icon payload is too large

• Request only the icon size you need.
• Cache icon results on the client side because the response can include a very large asset catalog.