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
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| type | string | No | - | OFFICIAL or CUSTOMER. Case-sensitive |
| keywords | string | No | - | Full-text match on MCP name, description, and related text. Ignored when blank |
| classification | string | No | - | Classification code. Exact match. ALL means no filter |
| pageNo | int | No | 1 | Page number, starting from 1 |
| pageSize | int | No | 20 | Number of items per page, from 1 to 100 |
pageNo × pageSize cannot exceed 10000.
Response
The data field:
| Field | Type | Description |
|---|---|---|
| items | array<DetailResponse> | MCP services on the current page. Each item contains the full detail fields. mcp_config is null |
| total | long | Total number of services |
| page_no | int | Current page number |
| page_size | int | Number of items per page |
Example
Errors
| HTTP status | error_code | Description |
|---|---|---|
| 400 | InvalidParameter | Pagination parameters are out of range, or an unsupported query parameter is provided |
| 500 | InternalError | Internal service error |
| 502 | McpUpstreamError | The downstream MCP operation failed |