ListMcpServices
Queries the list of MCP services.
Try it now
Test
RAM authorization
Request syntax
GET /digitalEmployee/{name}/mcpServices HTTP/1.1Path Parameters
|
Parameter |
Type |
Required |
Description |
Example |
| name |
string |
Yes |
The name of the digital employee. |
test-agent |
Request parameters
|
Parameter |
Type |
Required |
Description |
Example |
| maxResults |
integer |
No |
The maximum number of entries to return in this query. |
20 |
| nextToken |
string |
No |
The pagination token for the next query. |
eyJvZmZzZXQiOjIwfQ== |
Response elements
|
Element |
Type |
Description |
Example |
|
object |
The response parameters. |
||
| requestId |
string |
The request ID. |
0B9377D9-C56B-5C2E-A8A4-************ |
| total |
integer |
The total number of MCP services that match the query conditions. |
10 |
| maxResults |
integer |
The maximum number of entries to return in this query. |
20 |
| nextToken |
string |
The pagination token for the next query. |
eyJvZmZzZXQiOjIwfQ== |
| mcpServices |
object |
The paginated results of MCP services. |
|
| mcpServiceList |
array<object> |
The list of MCP services. |
|
|
array<object> |
The information about a single MCP service. |
||
| displayName |
string |
日志查询 |
|
| description |
string |
通过 MCP 调用日志查询工具。 |
|
| enable |
boolean |
true |
|
| network |
object |
||
| mode |
string |
public |
|
| vpcId |
string |
vpc-xxx |
|
| vswId |
string |
vsw-xxx |
|
| accessIp |
string |
10.0.0.12 |
|
| accessPort |
integer |
8080 |
|
| securityGroupId |
string |
sg-xxx |
|
| gatewayId |
string |
gw-xxx |
|
| mcpServerId |
string |
mcp-xxx |
|
| region |
string |
cn-hangzhou |
|
| connection |
object |
||
| platform |
string |
Custom |
|
| transport |
string |
http |
|
| endpoint |
string |
https://example.com/mcp |
|
| timeout |
integer |
5000 |
|
| auth |
object |
||
| type |
string |
bearer |
|
| keyInfo |
object |
{"token":"example-token"} |
|
|
string |
example-token |
||
| tools |
array<object> |
[{"name":"query_logs"}] |
|
|
array<object> |
[{"name":"query_logs"}] |
||
| name |
string |
query_logs |
|
| title |
string |
查询日志 |
|
| displayName |
string |
日志查询工具 |
|
| description |
string |
查询指定日志库中的日志。 |
|
| inputSchema |
object |
{"type":"object","properties":{"query":{"type":"string"}},"required":["query"]} |
|
|
any |
{"type":"string"} |
||
| outputSchema |
object |
{"type":"object"} |
|
|
any |
{"type":"string"} |
||
| icons |
array<object> |
[] |
|
|
object |
[] |
||
|
any |
https://example.com/icon.png |
||
| execution |
object |
{} |
|
|
any |
{} |
||
| annotations |
object |
{} |
|
|
any |
{} |
||
| enable |
boolean |
true |
|
| confirm |
boolean |
false |
|
| mcpServiceName |
string |
log-query |
Examples
Success response
JSON format
{
"requestId": "0B9377D9-C56B-5C2E-A8A4-************",
"total": 10,
"maxResults": 20,
"nextToken": "eyJvZmZzZXQiOjIwfQ==",
"mcpServices": {
"mcpServiceList": [
{
"displayName": "日志查询",
"description": "通过 MCP 调用日志查询工具。",
"enable": true,
"network": {
"mode": "public",
"vpcId": "vpc-xxx",
"vswId": "vsw-xxx",
"accessIp": "10.0.0.12",
"accessPort": 8080,
"securityGroupId": "sg-xxx",
"gatewayId": "gw-xxx",
"mcpServerId": "mcp-xxx",
"region": "cn-hangzhou"
},
"connection": {
"platform": "Custom",
"transport": "http",
"endpoint": "https://example.com/mcp",
"timeout": 5000,
"auth": {
"type": "bearer",
"keyInfo": {
"key": "example-token"
}
}
},
"tools": [
{
"name": "query_logs",
"title": "查询日志",
"displayName": "日志查询工具",
"description": "查询指定日志库中的日志。",
"inputSchema": {
"key": "{\"type\":\"string\"}"
},
"outputSchema": {
"key": "{\"type\":\"string\"}"
},
"icons": [
{
"key": "https://example.com/icon.png"
}
],
"execution": {
"key": "{}"
},
"annotations": {
"key": "{}"
},
"enable": true,
"confirm": false
}
],
"mcpServiceName": "log-query"
}
]
}
}Error codes
See Error Codes for a complete list.
Release notes
See Release Notes for a complete list.