List Tools

Overview

List tools with multiple output modes. Default mode='names' for quick scanning. Recommended workflow: start with default or mode='categories' for overview, then use 'get_tool_info' tool to get descriptions/details for specific tools (supports batch queries). Warning: modes like 'basic'/'summary' return very large payloads; use 'get_tool_info' instead for descriptions. If you must use these modes, use 'limit'/'offset' or filter by 'categories'. Modes: 'names' (default), 'basic', 'categories', 'by_category', 'summary', 'custom'.

Status

The most recent probe succeeded. Safe to call from the agent today.

Last probed

1d ago

Last success

1d ago

Last latency

107ms

Schema

JSON Schema the agent (or your API call) must match.

{
  "properties": {
    "brief": {
      "default": false,
      "description": "Whether to truncate description to brief (only for mode='basic' or 'summary')",
      "type": "boolean"
    },
    "categories": {
      "description": "Optional list of tool categories to filter by (applies to all modes except 'categories')",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "fields": {
      "description": "Required for mode='custom'. List of fields to include (e.g., [\"name\", \"type\", \"category\"])",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "group_by_category": {
      "default": false,
      "description": "Whether to group results by category (only for mode='names', 'basic', or 'summary')",
      "type": "boolean"
    },
    "limit": {
      "description": "Maximum number of tools to return (optional, for pagination)",
      "type": "integer"
    },
    "mode": {
      "default": "names",
      "description": "Output mode (default: 'names'). Warning: non-'names' modes like 'basic'/'summary' can return very large payloads when many tools are loaded. For getting tool descriptions, use 'get_tool_info' tool instead. Modes: 'names' (tool names only), 'basic' (name+description), 'categories' (category statistics), 'by_category' (grouped by category), 'summary' (name+description+type+has_parameters), 'custom' (user-specified fields)",
      "enum": [
        "names",
        "basic",
        "categories",
        "by_category",
        "summary",
        "custom"
      ],
      "type": "string"
    },
    "offset": {
      "default": 0,
      "description": "Number of tools to skip (optional, for pagination, default: 0)",
      "type": "integer"
    }
  },
  "required": [],
  "type": "object"
}

Examples (1)

{
  "brief": false,
  "categories": [],
  "fields": [],
  "group_by_category": false,
  "limit": 3,
  "offset": 1
}

Identifiers

Catalog ID

tu_list_tools

Tool name

list_tools

Added

2026-05-01 00:58Z

Tags

tooluniverse