Skip to main content
POST
/
api
/
v1
/
mcp
cURL
curl -sS \
  -X POST \
  -H 'Authorization: Bearer $OXI_SK' \
  -H 'Content-Type: application/json' \
  -d '{}' \
  'https://api.0xinsider.com/api/v1/mcp'
{
  "object": "mcp",
  "data": {},
  "meta": {
    "request_id": "req_example",
    "cached": false
  }
}
Hosted, streamable HTTP MCP endpoint. Use it when your agent can’t spawn a local npx subprocess: a serverless function, a browser-based agent, or a hosted automation runtime. Remote MCP exposes the 21 read-only V1 data operations below as tools. Each tool dispatches to the matching /api/v1/* handler in-process, so auth, rate limits, and payload contracts match direct REST calls. Meta endpoints (/usage, /health) and webhook mutations are not exposed as tools. The remote endpoint is tools-only. It supports initialize, notifications/initialized, ping, tools/list, and tools/call; it does not implement resources or prompts. Current tools:
  • get_leaderboard
  • get_trader
  • batch_get_traders
  • get_whale_trades
  • get_whale_trades_history
  • get_market_intel
  • batch_get_market_intel
  • get_market_snapshot
  • get_insider_radar
  • get_positions
  • get_position_timeline
  • get_position_timeline_by_id
  • search_markets
  • explore_markets
  • get_event_replay_since
  • list_webhooks
  • get_webhook
  • get_daily_report_snapshot
  • get_weekly_report_snapshot
  • get_monthly_report_snapshot
  • get_trader_export_snapshot

​
Authentication

Prefer the header form: 
curl -X POST \
  -H "Authorization: Bearer $OXINSIDER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc": "2.0", "id": 1, "method": "tools/list"}' \
  https://api.0xinsider.com/api/v1/mcp
A ?token=... query parameter is still available for URL-only clients but is legacy. URL secrets leak into shell history, browser history, proxies, and logs. Use headers wherever you can. For the streaming response, see Remote MCP Stream.

Authorizations

​
Authorization
string
header
required

API key: Authorization: Bearer oxi_sk_live_... for live data (requires an active Insider subscription), or oxi_sk_test_... for sandbox/test mode (free account, deterministic fixture data, no live rows). Both key classes use the same paths; the prefix selects live vs sandbox.

Headers

​
Mcp-Session-Id
string

Session ID minted by the server on initialize; echoed on every subsequent request.

Query Parameters

​
token
string

Deprecated compatibility API-key query parameter for remote MCP clients that cannot send Authorization headers. Prefer Authorization: Bearer or the stdio package because URL secrets are easier to leak through logs and history.

Body

application/json
​
jsonrpc
string
required
Allowed value: "2.0"
​
method
enum<string>
required
Available options:
initialize,
notifications/initialized,
ping,
tools/list,
tools/call
​
id
​
params
object

Response

JSON-RPC response

​
jsonrpc
string
required
Allowed value: "2.0"
​
id
required
​
result
object
​
error
object