Skip to main content
Version: 2.0

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 results
  • type (string, optional): Filter tools by type (allowed value: mcp)
  • enabled (boolean, optional): Filter tools by enabled status
  • limit (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

EXAMPLE REQUEST
1

Example Response

EXAMPLE RESPONSE
1

Error Responses

The API returns standard HTTP error codes with detailed error information:

HTTP CodeError CodeDescription
400invalid_requestInvalid query parameters or malformed request
401unauthorizedInvalid or missing API key
403forbiddenInsufficient permissions for tool operations
429rate_limit_exceededRequest rate limit exceeded
500internal_errorInternal server error during tool retrieval