Skip to Content
Getting StartedUse MCP Service

Call MCP

Hosted MCP is the shortest path for agent runtimes that already understand tool calls. Keep the bearer API key, point at the hosted MCP URL, and run one market tool first.

Use the hosted MCP URL directly. Do not point MCP clients at the gateway base URL.

Access

Endpoint variable
{MCP_SERVER_URL}
Auth header
Authorization: Bearer {API_KEY}
Recommended tools
market.read_price, market.resolve_asset, market.resolve_market, market.read_ohlcv

How to call MCP

Prepare the bearer token

Create the API key first if needed, then keep the bearer token ready.

Set the hosted MCP server URL

Point your runtime at {MCP_SERVER_URL}, not the gateway base URL.

Start with one simple market tool

Use market.read_price first, then widen into more tools only after the first response is working.

  • market.read_price: latest normalized price for one known asset
  • market.resolve_asset: asset identity and metadata lookup
  • market.resolve_market: market or pair lookup
  • market.read_ohlcv: short-range OHLCV window for one known asset

These tools map to the same hosted market reads exposed in Market API.

Hosted MCP example

{ "server_url": "{MCP_SERVER_URL}", "headers": { "Authorization": "Bearer {api_key}" } }

Confirm one successful MCP response, then widen into more tools.

  • Get API Key: prepare the API key before configuring hosted MCP.
  • Market API: open the market handles behind the tool names.
  • Market WebSocket: move into realtime market delivery when request-response is already working.
Last updated on