List Tools Command

The agent tools list command displays all tools that are available or currently configured for a specific AI Agent.

Usage

xpander agent tools list <agent_id> [--status <status>] [--format <format>]

Options

OptionDescription
--status <status>Optional. Filter by status: available, configured, all (default)
--format <format>Optional. Output format: table (default), json, or wide

Examples

List All Tools

xpander agent tools list agent_123

Response:

TOOL NAME          STATUS       LAST USED           CONFIG
notion            Connected    2024-02-19 13:40    Workspace: Support Team
slack             Connected    2024-02-19 13:45    Channels: #support, #general
calendar          Connected    2024-02-19 12:30    Calendar: support@company.com
github            Available    -                    -
jira              Available    -                    -

List Configured Tools

xpander agent tools list agent_123 --status configured

Response:

TOOL NAME          STATUS       LAST USED           CONFIG
notion            Connected    2024-02-19 13:40    Workspace: Support Team
slack             Connected    2024-02-19 13:45    Channels: #support, #general
calendar          Connected    2024-02-19 12:30    Calendar: support@company.com

JSON Format

xpander agent tools list agent_123 --format json

Response:

{
  "tools": {
    "configured": [
      {
        "name": "notion",
        "status": "connected",
        "last_used": "2024-02-19T13:40:12Z",
        "config": {
          "workspace": "Support Team"
        }
      },
      // ... more configured tools
    ],
    "available": [
      {
        "name": "github",
        "description": "GitHub integration for code and issue management",
        "auth_type": "oauth2"
      },
      // ... more available tools
    ]
  }
}

Notes

  • Available tools are those that can be added to the agent
  • Configured tools are those already set up for the agent
  • The wide format includes additional details like:
    • Authentication status
    • Usage statistics
    • Configuration details
  • Use xpander agent tools add to configure available tools