MCP

Remote MCP endpoint (JSON-RPC)

Model Context Protocol (MCP) Streamable HTTP transport. Accepts a JSON-RPC 2.0 request and returns a JSON-RPC response. Supported methods: initialize, notifications/initialized, ping, tools/list, tools/call. Remote MCP exposes 33 read-only tools for public V1 read operations: get_leaderboard, get_trader, batch_get_traders, get_whale_trades, get_whale_trade, get_whale_trades_history, get_market_intel, batch_get_market_intel, get_smart_money_flows, get_sharp_money_flows, get_market_snapshot, get_insider_radar, get_insider_radar_flag, get_positions, get_position_timeline, get_position_timeline_by_id, search_markets, search_content, explore_markets, get_event_replay_since, list_webhooks, get_webhook, get_daily_report_snapshot, get_weekly_report_snapshot, get_monthly_report_snapshot, get_report, get_trader_export_snapshot, get_platforms, get_large_positions, get_trending_wallets, get_trader_pnl, get_pick_of_the_day, get_pick_of_the_day_archive. Webhook create/update/delete/verify/rotate operations are intentionally not exposed as remote MCP tools. The remote endpoint advertises tools only; it does not implement resources/list, resources/read, prompts/list, or prompts/get. Each tool dispatches to the matching /api/v1/* handler in-process so auth, rate limits, and payload shape match. Auth should use Authorization: Bearer <token>. ?token=<token> remains a legacy compatibility path for URL-only MCP clients, but URL secrets can land in shell history, browser history, and logs, so prefer headers or the stdio package. Mcp-Session-Id is minted on initialize and echoed on every response. Origin header, when present, is validated against the 0xinsider + localhost allowlist.

post/api/v1/mcp

Query parameters

tokenstring

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

Headers

Mcp-Session-Idstring

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

Request body

jsonrpc'2.0' required

JSON-RPC protocol version; this server accepts 2.0.

method'initialize' | 'notifications/initialized' | 'ping' | 'tools/list' | 'tools/call' required

MCP method to invoke.

paramsobject

Method-specific MCP parameters.

Response

JSON-RPC response

jsonrpc'2.0' required

resultobject

Changes

Changed in 6 of the 31 revisions of this API.5376

Aug 29, 20267c0c7cdd41ee5See the full diff
- ●
  added the new database_unavailable enum value to the error/reason response property for the response status 401
  response-property-enum-value-added
- ●
  added the new database_unavailable enum value to the error/reason response property for the response status 402
  response-property-enum-value-added
- ●
  added the new database_unavailable enum value to the error/reason response property for the response status 403
  response-property-enum-value-added
- ●
  added the new database_unavailable enum value to the error/reason response property for the response status 429
  response-property-enum-value-added
- ●
  added the new database_unavailable enum value to the error/reason response property for the response status 500
  response-property-enum-value-added
Aug 29, 20268582a359fa07410See the full diff
- ●
  the optional response header X-RateLimit-Limit removed for the status 202
  optional-response-header-removed
- ●
  the optional response header X-RateLimit-Remaining removed for the status 202
  optional-response-header-removed
- ●
  the optional response header X-RateLimit-Reset removed for the status 202
  optional-response-header-removed
- ●
  the optional response header X-Request-Id removed for the status 202
  optional-response-header-removed
- ○
  added the media type application/json for the response with the status 400
  response-media-type-added
- ○
  added the media type application/json for the response with the status 403
  response-media-type-added
- ○
  added the optional property meta/ranking_as_of to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property meta/ranking_as_of to the response with the 402 status
  response-optional-property-added
- ○
  added the optional property meta/ranking_as_of to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property meta/ranking_as_of to the response with the 500 status
  response-optional-property-added
- ○
  added the optional property meta/ranking_generation to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property meta/ranking_generation to the response with the 402 status
  response-optional-property-added
- ○
  added the optional property meta/ranking_generation to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property meta/ranking_generation to the response with the 500 status
  response-optional-property-added
Jul 30, 202619193b177154844See the full diff
- ●
  added the new idempotency_in_progress enum value to the error/reason response property for the response status 401
  response-property-enum-value-added
- ●
  added the new idempotency_in_progress enum value to the error/reason response property for the response status 402
  response-property-enum-value-added
- ●
  added the new idempotency_in_progress enum value to the error/reason response property for the response status 429
  response-property-enum-value-added
- ●
  added the new idempotency_in_progress enum value to the error/reason response property for the response status 500
  response-property-enum-value-added
- ●
  added the new webhook_delivery_in_progress enum value to the error/reason response property for the response status 401
  response-property-enum-value-added
- ●
  added the new webhook_delivery_in_progress enum value to the error/reason response property for the response status 402
  response-property-enum-value-added
- ●
  added the new webhook_delivery_in_progress enum value to the error/reason response property for the response status 429
  response-property-enum-value-added
- ●
  added the new webhook_delivery_in_progress enum value to the error/reason response property for the response status 500
  response-property-enum-value-added
- ○
  added the optional property meta/category_skill_base_payload_hash to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_base_payload_hash to the response with the 402 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_base_payload_hash to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_base_payload_hash to the response with the 500 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_enriched_base_payload_hash to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_enriched_base_payload_hash to the response with the 402 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_enriched_base_payload_hash to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_enriched_base_payload_hash to the response with the 500 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_model_operationally_degraded to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_model_operationally_degraded to the response with the 402 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_model_operationally_degraded to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_model_operationally_degraded to the response with the 500 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_model_version to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_model_version to the response with the 402 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_model_version to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_model_version to the response with the 500 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_observation_started_at to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_observation_started_at to the response with the 402 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_observation_started_at to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_observation_started_at to the response with the 500 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_platform to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_platform to the response with the 402 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_platform to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_platform to the response with the 500 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_scope to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_scope to the response with the 402 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_scope to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_scope to the response with the 500 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_source to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_source to the response with the 402 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_source to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_source to the response with the 500 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_source_coverage to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_source_coverage to the response with the 402 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_source_coverage to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_source_coverage to the response with the 500 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_status_counts to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_status_counts to the response with the 402 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_status_counts to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_status_counts to the response with the 500 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_taxonomy_version to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_taxonomy_version to the response with the 402 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_taxonomy_version to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_taxonomy_version to the response with the 500 status
  response-optional-property-added
Jul 14, 202622ab6cfbf30020See the full diff
- ○
  added the optional property error/reason to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property error/reason to the response with the 402 status
  response-optional-property-added
- ○
  added the optional property error/reason to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property error/reason to the response with the 500 status
  response-optional-property-added
- ○
  added the optional property error/retry_at to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property error/retry_at to the response with the 402 status
  response-optional-property-added
- ○
  added the optional property error/retry_at to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property error/retry_at to the response with the 500 status
  response-optional-property-added
- ○
  added the optional property meta/directional_source to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property meta/directional_source to the response with the 402 status
  response-optional-property-added
- ○
  added the optional property meta/directional_source to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property meta/directional_source to the response with the 500 status
  response-optional-property-added
- ○
  added the optional property meta/ranking_source to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property meta/ranking_source to the response with the 402 status
  response-optional-property-added
- ○
  added the optional property meta/ranking_source to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property meta/ranking_source to the response with the 500 status
  response-optional-property-added
- ○
  added the required property meta/cost to the response with the 401 status
  response-required-property-added
- ○
  added the required property meta/cost to the response with the 402 status
  response-required-property-added
- ○
  added the required property meta/cost to the response with the 429 status
  response-required-property-added
- ○
  added the required property meta/cost to the response with the 500 status
  response-required-property-added
Jun 1, 2026422bd4dc1611361See the full diff
- ●
  added the new account_locked enum value to the error/code response property for the response status 401
  response-property-enum-value-added
- ●
  added the new account_locked enum value to the error/code response property for the response status 402
  response-property-enum-value-added
- ●
  added the new account_locked enum value to the error/code response property for the response status 429
  response-property-enum-value-added
- ●
  added the new account_locked enum value to the error/code response property for the response status 500
  response-property-enum-value-added
- ●
  added the new bad_request enum value to the error/code response property for the response status 401
  response-property-enum-value-added
- ●
  added the new bad_request enum value to the error/code response property for the response status 402
  response-property-enum-value-added
- ●
  added the new bad_request enum value to the error/code response property for the response status 429
  response-property-enum-value-added
- ●
  added the new bad_request enum value to the error/code response property for the response status 500
  response-property-enum-value-added
- ●
  added the new forbidden enum value to the error/code response property for the response status 401
  response-property-enum-value-added
- ●
  added the new forbidden enum value to the error/code response property for the response status 402
  response-property-enum-value-added
- ●
  added the new forbidden enum value to the error/code response property for the response status 429
  response-property-enum-value-added
- ●
  added the new forbidden enum value to the error/code response property for the response status 500
  response-property-enum-value-added
- ●
  added the new internal_error enum value to the error/code response property for the response status 401
  response-property-enum-value-added
- ●
  added the new internal_error enum value to the error/code response property for the response status 402
  response-property-enum-value-added
- ●
  added the new internal_error enum value to the error/code response property for the response status 429
  response-property-enum-value-added
- ●
  added the new internal_error enum value to the error/code response property for the response status 500
  response-property-enum-value-added
- ●
  added the new invalid_api_key enum value to the error/code response property for the response status 401
  response-property-enum-value-added
- ●
  added the new invalid_api_key enum value to the error/code response property for the response status 402
  response-property-enum-value-added
- ●
  added the new invalid_api_key enum value to the error/code response property for the response status 429
  response-property-enum-value-added
- ●
  added the new invalid_api_key enum value to the error/code response property for the response status 500
  response-property-enum-value-added
- ●
  added the new not_found enum value to the error/code response property for the response status 401
  response-property-enum-value-added
- ●
  added the new not_found enum value to the error/code response property for the response status 402
  response-property-enum-value-added
- ●
  added the new not_found enum value to the error/code response property for the response status 429
  response-property-enum-value-added
- ●
  added the new not_found enum value to the error/code response property for the response status 500
  response-property-enum-value-added
- ●
  added the new rate_limit_unavailable enum value to the error/code response property for the response status 401
  response-property-enum-value-added
- ●
  added the new rate_limit_unavailable enum value to the error/code response property for the response status 402
  response-property-enum-value-added
- ●
  added the new rate_limit_unavailable enum value to the error/code response property for the response status 429
  response-property-enum-value-added
- ●
  added the new rate_limit_unavailable enum value to the error/code response property for the response status 500
  response-property-enum-value-added
- ●
  added the new rate_limited enum value to the error/code response property for the response status 401
  response-property-enum-value-added
- ●
  added the new rate_limited enum value to the error/code response property for the response status 402
  response-property-enum-value-added
- ●
  added the new rate_limited enum value to the error/code response property for the response status 429
  response-property-enum-value-added
- ●
  added the new rate_limited enum value to the error/code response property for the response status 500
  response-property-enum-value-added
- ●
  added the new subscription_required enum value to the error/code response property for the response status 401
  response-property-enum-value-added
- ●
  added the new subscription_required enum value to the error/code response property for the response status 402
  response-property-enum-value-added
- ●
  added the new subscription_required enum value to the error/code response property for the response status 429
  response-property-enum-value-added
- ●
  added the new subscription_required enum value to the error/code response property for the response status 500
  response-property-enum-value-added
- ○
  api operation id mcp_post removed and replaced with createMcpJsonRpcResponse
  api-operation-id-removed
May 7, 20262907497f4ca31See the full diff
- ○
  endpoint added
  endpoint-added

Full history