Lists the tool names, descriptions, and input schemas provided by an MCP service.
Endpoint
GET /api/v1/mcp/servers/{mcpCode}/tools
Returns the tools currently available in the specified MCP service.
Request parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| mcpCode | string | Yes | MCP code |
Response
data is an array of tools. Each tool contains the following fields:
| Field | Type | Description |
|---|---|---|
| name | string / null | Tool name |
| description | string / null | Tool description |
| inputSchema | object / null | Tool input schema |
| inputSchema.type | string / null | Usually object |
| inputSchema.properties | map<string,object> / null | Parameter definitions |
| inputSchema.required | array<string> / null | Required parameter names |
| inputSchema.additionalProperties | boolean / null | Whether additional parameters are allowed |
Example
Errors
| HTTP status | error_code | Description |
|---|---|---|
| 400 | - | The service is not activated, the instance is abnormal, or the tool list is empty. The error code is returned by the MCP service |
| 500 | InternalError | Internal service error |
One Key MCP services do not need to be activated in advance. The service may be activated automatically when tools are first listed or called.