Create MCP Tool Group

Creates a new tool group along with its attachments in a single transaction. Validates that every mcp_client_id points to a deployed MCP client and that every named tool exists on its server.

POST /api/mcp/tool-groups

Error

A valid request URL is required to generate request examples

201

{
  "mcp_tool_group": {
    "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"
  }
}

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.

Body

application/json

name · string · required

Maximum string length: 255

tools · object[] · required

Show child attributes

description · string

enabled · boolean

If omitted, the group is created with enabled: false. Send true explicitly to activate the group on creation.

virtual_key_ids · string[]

team_ids · string[]

customer_ids · string[]

user_ids · string[]

provider_names · string[]

api_key_ids · integer<uint>[]

Response

201

application/json

Group created

mcp_tool_group · object

Show child attributes