Mcp Tool Groups

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
AuthorizationBearer <token>

Bearer token authentication. Use your MPilot virtual-key JWT or admin JWT. Virtual keys (prefixed with sk-bf-) can also be passed here.

In: header

namestring
Lengthlength <= 255
description?string
enabled?boolean

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

toolsarray<object>
virtual_key_ids?array<string>
team_ids?array<string>
customer_ids?array<string>
user_ids?array<string>
provider_names?array<string>
api_key_ids?array<integer>

Response Body

curl -X POST "https://loading/{AI_GATEWAY_URL}/api/mcp/tool-groups" \  -H "Content-Type: application/json" \  -d '{    "name": "string",    "tools": [      {        "mcp_client_id": "string"      }    ]  }'
{
  "mcp_tool_group": {
    "id": 0,
    "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": [
      0
    ],
    "created_at": "2019-08-24T14:15:22Z",
    "updated_at": "2019-08-24T14:15:22Z"
  }
}
Empty
{
  "event_id": "string",
  "type": "string",
  "is_bifrost_error": true,
  "status_code": 0,
  "error": {
    "type": "string",
    "code": "string",
    "message": "string",
    "param": "string",
    "event_id": "string"
  },
  "extra_fields": {
    "provider": "openai",
    "model_requested": "string",
    "request_type": "string"
  }
}
On this page

On this page

No Headings