> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getoutbox.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# List Agent Tools

> Retrieve a list of all tools for an agent (simplified view)



## OpenAPI

````yaml GET /agent/tool/{agent_id}
openapi: 3.1.0
info:
  title: Outbox AI API
  description: API for managing AI agents (chatbots and voicebots) on the Outbox platform
  version: 1.0.0
servers:
  - url: https://api.getoutbox.ai
security: []
paths:
  /agent/tool/{agent_id}:
    get:
      summary: List Agent Tools
      description: Retrieve a list of all tools for an agent (simplified view)
      parameters:
        - name: agent_id
          in: path
          description: The ID of the agent
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Tools retrieved successfully
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ToolSimple'
        '401':
          description: Unauthorized - Invalid or missing API key
        '404':
          description: Agent not found
      security:
        - CompanyApiKey: []
components:
  schemas:
    ToolSimple:
      type: object
      properties:
        id:
          type: string
          format: uuid
        name:
          type: string
        type:
          type: string
          description: '`custom`, `builtin`, `mcp`, `transfer`, etc.'
        builtin_key:
          type: string
          nullable: true
          description: Built-in tool key (builtin tools only).
        display_name:
          type: string
          nullable: true
          description: Resolved display name for built-in or MCP tools.
        mcp_tool:
          type: string
          nullable: true
          description: MCP tool identifier (mcp tools only).
        url:
          type: string
          nullable: true
        description:
          type: string
          nullable: true
        method:
          type: string
          nullable: true
          description: HTTP method (custom tools).
        auth_token:
          type: string
          nullable: true
        config:
          type: object
          additionalProperties: true
          description: Preset tool inputs supplied by the developer.
        is_async:
          type: boolean
        is_success:
          type: boolean
        is_prerun:
          type: boolean
        is_postrun:
          type: boolean
        schema:
          type: array
          description: Tool input variables.
          items:
            $ref: '#/components/schemas/ToolParameter'
        destinations:
          type: array
          description: >-
            Transfer destinations (transfer tools only). Each entry: id,
            phone_number, description, transfer_message, transfer_type, plus
            optional `custom_message`, `fallback_message`, `extension`,
            `transfer_agent_prompt`, `assistant_first_message*`.
          items:
            type: object
        mcp_config_id:
          type: string
          nullable: true
          description: Composio MCP server ID (mcp tools only).
        mcp_allowed_tools:
          type: array
          items:
            type: string
          description: Allowed-tool whitelist for MCP servers.
        mcp_toolkit:
          type: string
          nullable: true
        icon_url:
          type: string
          nullable: true
          description: Application icon URL (mcp tools only).
        application_icon_url:
          type: string
          nullable: true
          description: Application icon URL for resolved tool metadata.
    ToolParameter:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
        description:
          type: string
        type:
          type: string
        required:
          type: boolean
  securitySchemes:
    CompanyApiKey:
      type: apiKey
      in: header
      name: Authorization
      description: Company API Key

````