List MCP Servers

Retrieves a paginated list of MCP servers for the application. Use this endpoint to browse and manage MCP server configurations.

GET /ai-agents/agent-builder/mcp-servers

List MCP Servers

cURL

curl --request GET \
  --url https://{appId}.api-{region}.cometchat.io/v3/ai-agents/agent-builder/mcp-servers \
  --header 'apikey: <api-key>'

200

{
  "data": [
    {
      "_id": "myapp_my-mcp-server",
      "appId": "my-app-id",
      "slug": "my-mcp-server",
      "name": "My MCP Server",
      "description": "A Model Context Protocol server",
      "url": "https://mcp.example.com/sse",
      "icon": "https://example.com/icon.png",
      "createdAt": 1700000000000,
      "updatedAt": 1700000000000
    }
  ],
  "meta": {
    "previous": {
      "affix": "prepend",
      "createdAt": 1700000000000
    },
    "current": {
      "limit": 10,
      "count": 1
    },
    "next": {
      "affix": "append",
      "createdAt": 1700000000000
    }
  }
}

For the complete error reference, see Error Guide.

Authorizations

apikey · string · header · required

API Key (i.e. Rest API Key from the Dashboard).

Query Parameters

limit · number

Maximum number of results to return per page.

affix · enum<string>

To paginate over results, use the value of affix as prepend or append.

Available options: prepend, append

createdAt · number

To be used with affix for pagination.

Response

200 - application/json

Paginated list of MCP servers

data · object[]

Show child attributes

meta · object

Show child attributes