List MCP Tool Groups

Returns tool groups visible to the caller. When all of limit, offset, and search are omitted, every group is returned in one response.

GET /api/mcp/tool-groups

Error

A valid request URL is required to generate request examples

200

{
  "mcp_tool_groups": [
    {
      "id": 123,
      "name": "<string>",
      "description": "<string>",
      "enabled": true,
      "tools": [
        {
          "mcp_client_id": "<string>",
          "tool_names": [
            "<string>"
          ]
        }
      ],
      "virtual_key_ids": [
        "<string>"
      ],
      "team_ids": [
        "<string>"
      ],
      "customer_ids": [
        "<string>"
      ],
      "user_ids": [
        "<string>"
      ],
      "provider_names": [
        "<string>"
      ],
      "api_key_ids": [
        123
      ],
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z"
    }
  ],
  "count": 123,
  "total_count": 123,
  "limit": 123,
  "offset": 123
}

Authorizations

Authorization · string · header · required

Management API authentication for /api/* endpoints. Use the Authorization header with Bearer <API key>. Virtual keys, dashboard/user/session tokens, and x-api-key headers are not supported on management APIs.

Query Parameters

limit · integer

offset · integer

search · string

Search by name.

Response

200

application/json

Successful response

mcp_tool_groups · object[]

Show child attributes

count · integer

total_count · integer

limit · integer

offset · integer