Skip to main content

List MCP services

Lists official MCP services and custom MCP services in the current workspace by page, with optional filters for type, keyword, and classification.

Endpoint

GET /api/v1/mcp/servers/list If type is not specified, the response contains official MCP services and custom MCP services in the current workspace.

Request parameters

ParameterTypeRequiredDefaultDescription
typestringNo-OFFICIAL or CUSTOMER. Case-sensitive
keywordsstringNo-Full-text match on MCP name, description, and related text. Ignored when blank
classificationstringNo-Classification code. Exact match. ALL means no filter
pageNointNo1Page number, starting from 1
pageSizeintNo20Number of items per page, from 1 to 100
pageNo × pageSize cannot exceed 10000.

Response

The data field:
FieldTypeDescription
itemsarray<DetailResponse>MCP services on the current page. Each item contains the full detail fields. mcp_config is null
totallongTotal number of services
page_nointCurrent page number
page_sizeintNumber of items per page

Example

curl "https://{workspace_id}.cn-beijing.maas.aliyuncs.com/api/v1/mcp/servers/list?type=CUSTOMER&keywords=weather&pageNo=1&pageSize=20" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY"
{
  "success": true,
  "error_code": null,
  "error_msg": null,
  "data": {
    "items": [
      {
        "mcp_code": "mcp-a1b2c3d4e5f6g7h8",
        "server_name": "weather-mcp",
        "description": "Weather query MCP",
        "type": "CUSTOMER",
        "server_type": "HTTP",
        "server_status": "ACTIVATED",
        "server_status_text": "已启用",
        "dashscope_endpoint": "https://{workspace_id}.cn-beijing.maas.aliyuncs.com/api/v1/mcps/mcp-a1b2c3d4e5f6g7h8/mcp",
        "meta_info": {
          "console_detail_url": "https://bailian.console.aliyun.com/flow-agent/mcp-manage/detail/mcp-a1b2c3d4e5f6g7h8/custom",
          "classification": "生活服务",
          "activate_user_count": 10,
          "call_total_count": 1200,
          "average_call_time": 125,
          "call_success_rate": 0.99
        },
        "mcp_config": null
      }
    ],
    "total": 1,
    "page_no": 1,
    "page_size": 20
  },
  "request_id": "6f1c2a8e-3b0d-4c55-9a0e-2f7d1c9b8a11"
}

Errors

HTTP statuserror_codeDescription
400InvalidParameterPagination parameters are out of range, or an unsupported query parameter is provided
500InternalErrorInternal service error
502McpUpstreamErrorThe downstream MCP operation failed