List Tools
This method allows you to list tools available from configured MCP servers.
Optional object ID after which to resume pagination.
Optional object ID after which to resume pagination.
Number of objects to return in the request.
Skip this many objects in the returned list. This can be used for pagination (instead of, or in addition to, using after/before), but it is less robust to list changes occurring during pagination.
Order (based on create time) for returned objects.
If set, calculate the total number of objects that match the request, and include the value as num_objects in the response. Calculating the size of large listings may be costly and is disabled by default.
A list of tool IDs to filter by. Returns only tools matching any of the specified IDs.
A list of MCP servers for which to list tools. For tools from external MCP servers, the item to filter on is the MCP Server ID; for tools from the built-in MCP server, use "built-in".
Filter tools by approval status. If not set, both approved and unapproved tools are returned.
Filter tools by availability status.
The fields to sort the tools by, specified in order of precedence.
Successful Response
{
"object": "string",
"has_more": false,
"num_objects": 0,
"data": [
{
"id": "string",
"server": {
"id": "string",
"name": "string"
},
"tool_type": "string",
"tool_configuration_type": "string",
"origin_name": "string",
"description": "string",
"annotations": "string",
"input_schema": "string",
"output_schema": "string",
"is_approved": false,
"availability": "string",
"last_available_at": 0,
"last_updated_at": 0,
"num_linked_agents": 0
}
],
"first_id": "string",
"last_id": "string"
}Object type, which is always list.
True, if the server may have more objects than returned in the response.
Total number of objects that match the request. Note that this field is populated only if requested by the user (see set_num_objects request parameter).
List of Tools.
ID of the first element in the list (if any)
ID of the last element in the list (if any)
An invalid ID was passed for paginating results.
Validation Error
{
"detail": [
{
"loc": [
{}
],
"msg": "string",
"type": "string"
}
]
}detail
curl -H 'Authorization: <value>' https://{api_host}/api/v1/control/mcp-servers/tools