List Tools API Definition
The List Tools API enables you to retrieve and browse all available tools discovered from registered Model Context Protocol (MCP) compliant tool servers, providing comprehensive visibility into the complete catalog of enterprise capabilities accessible to AI agents. This API facilitates tool discovery, capability planning, and agent configuration by presenting the unified tool ecosystem.
Development teams and administrators use this API to explore available enterprise integrations for agent configuration, audit tool availability across different business systems, support tool selection during agent development workflows, and maintain operational awareness of the complete capability landscape that powers their AI agent infrastructure.
List Tools Request and Response
To list tools, send a GET request to /v2/tools
. You can optionally specify the following query parameters:
filter
(string, optional): A regular expression against tool names and descriptions to filter the resultstype
(string, optional): Filter tools by type (allowed value:mcp
)enabled
(boolean, optional): Filter tools by enabled statuslimit
(integer, optional): Maximum number of tools to return per page (1-100, defaults to 10)page_key
(string, optional): Pagination token from previous response to retrieve next page of results
The response includes an array of tool definitions with complete metadata including source tool server information, capability descriptions, parameter schemas, and operational details along with pagination information for retrieving additional results.
Example Request
1
Example Response
1
Error Responses
The API returns standard HTTP error codes with detailed error information:
HTTP Code | Error Code | Description |
---|---|---|
400 | invalid_request | Invalid query parameters or malformed request |
401 | unauthorized | Invalid or missing API key |
403 | forbidden | Insufficient permissions for tool operations |
429 | rate_limit_exceeded | Request rate limit exceeded |
500 | internal_error | Internal server error during tool retrieval |