Skip to Content

MCP API

The MCP API powers the AI Chat tool ecosystem: marketplace discovery, user installation, personal testing, public publishing, reviews, and admin moderation.

Market Endpoints

List MCP Servers

GET /api/v1/mcp/servers?category=market-data&search=okx&sort=popular&limit=50&offset=0

Returns approved servers from the public MCP Market.

Get MCP Server Detail

GET /api/v1/mcp/servers/{slug}

Returns a single approved MCP server definition, including display metadata, discovered tools, install counts, and review summary.

Install Management

These endpoints require Privy JWT authentication.

List Installed Servers

GET /api/v1/mcp/installed

Returns the current user’s installed MCP servers.

Install a Market Server

POST /api/v1/mcp/install
Content-Type: application/json
 
{
  "slug": "okx-cex-market",
  "config": {}
}

Enable or Disable an Installed Server

PATCH /api/v1/mcp/installed/{install_id}
Content-Type: application/json
 
{
  "is_enabled": true
}

Disabled installations are not exposed to AI Chat.

Uninstall a Server

DELETE /api/v1/mcp/installed/{install_id}

Personal Install

Personal install is for private testing. It does not publish the server to the public market.

POST /api/v1/mcp/personal-install
Content-Type: application/json
 
{
  "name": "Local OKX Market Test",
  "slug": "local-okx-market-test",
  "mcp_server": {
    "mcpServers": {
      "local-okx-market-test": {
        "command": "npx",
        "args": ["-y", "@okx_ai/okx-trade-mcp", "--modules", "market"]
      }
    }
  }
}

Publishing

Publish From Snippet

POST /api/v1/mcp/publish-snippet
Content-Type: application/json
Authorization: Bearer <Privy JWT>
{
  "name": "OKX CEX Market Data",
  "slug": "okx-cex-market-dev",
  "description": "Read-only OKX market data tools for AI Chat.",
  "category": "market-data",
  "icon_url": "https://www.okx.com/favicon.ico",
  "mcp_server": {
    "mcpServers": {
      "okx-cex-market-dev": {
        "command": "npx",
        "args": ["-y", "@okx_ai/okx-trade-mcp", "--modules", "market"]
      }
    }
  }
}

The platform discovers tools from the snippet and creates a pending market submission. Admin approval is required before the server appears in the public market.

Reviews

List Reviews

GET /api/v1/mcp/servers/{slug}/reviews?limit=50&offset=0

Create a Review

POST /api/v1/mcp/servers/{slug}/reviews
Content-Type: application/json
 
{
  "rating": 5,
  "comment": "Useful server"
}

Delete a Review

DELETE /api/v1/mcp/reviews/{review_id}

Admin Review

Admin endpoints are used by MCP Manager to inspect submissions, approve or reject servers, request more information, suspend listings, and remove invalid entries.

Public developers usually do not call admin endpoints directly.

Why This API Matters

AI Chat needs a real extension ecosystem rather than a fixed set of built-in tools. MCP APIs provide the marketplace, installation, and review model for that layer while keeping execution-sensitive strategy logic in Skills and trading agents.

Authentication