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

Query Parameters

limit?integer
offset?integer
search?string

Search by name.

Response Body

curl -X GET "https://loading/{AI_GATEWAY_URL}/api/mcp/tool-groups?limit=0&offset=0&search=string"
{
  "mcp_tool_groups": [
    {
      "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"
    }
  ],
  "count": 0,
  "total_count": 0,
  "limit": 0,
  "offset": 0
}
{
  "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