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

# List Agent Tools

> The tools of the agent's latest declaration, by name, each with its definition: the service it is in, its description, input and output schemas and the labels its server gives it  
Each carries its risk level from 1 to 10 and the reasons behind it, or `pending` until it is assessed  
What the policy allows of each tool is `GET /agents/policy/:did`



## OpenAPI

````yaml /versions/2026-11-02.yaml get /agents/tools/{did}
openapi: 3.1.0
info:
  title: Humanos API
  description: Humanos API
  version: '1.0'
  contact: {}
servers:
  - url: https://api.humanos.tech
security: []
tags:
  - name: Agents
  - name: Requests
  - name: Credentials
  - name: Approval
  - name: User
  - name: Actions
  - name: Audit trail
  - name: DID
  - name: Call proof
  - name: Webhooks
paths:
  /agents/tools/{did}:
    get:
      tags:
        - Agents
      summary: List Agent Tools
      description: >-
        The tools of the agent's latest declaration, by name, each with its
        definition: the service it is in, its description, input and output
        schemas and the labels its server gives it  

        Each carries its risk level from 1 to 10 and the reasons behind it, or
        `pending` until it is assessed  

        What the policy allows of each tool is `GET /agents/policy/:did`
      operationId: agents_tools
      parameters:
        - name: did
          required: true
          in: path
          description: The agent's DID, URL-encoded.
          schema:
            example: did:web:humanos.tech:agent:2f8b6c41-9d37-4e5a-8b02-6c1d9e7a4f35
            type: string
        - name: pageIndex
          required: false
          in: query
          description: Zero-based page index. `0` returns the first page.
          schema:
            minimum: 0
            default: 0
            example: 0
            type: number
        - name: pageSize
          required: false
          in: query
          description: Number of items per page
          schema:
            minimum: 5
            maximum: 100
            default: 10
            example: 10
            type: number
        - $ref: '#/components/parameters/ApiVersion'
      responses:
        '200':
          description: >-
            Returns a page of the agent's tools plus the total number of pages
            available.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentToolsEntity'
        '404':
          description: >-
            The agent is unknown, or another organization operates it: an
            organization only reads its own agents.
          content:
            application/json:
              schema:
                type: object
                properties:
                  statusCode:
                    type: number
                    example: 404
                  message:
                    type: string
                    example: agent not found
                  error:
                    type: string
                    example: Not Found
components:
  parameters:
    ApiVersion:
      name: API-Version
      in: header
      required: false
      schema:
        type: string
        pattern: ^\d{4}-\d{2}-\d{2}$
        example: '2026-11-02'
      description: >-
        Pin request, response, and webhook shapes to a specific dated API
        version (YYYY-MM-DD). Omit to use the version pinned to your API key
        (set when the key is created; new keys default to the latest version).
        New integrations should target the latest version.
  schemas:
    AgentToolsEntity:
      type: object
      properties:
        data:
          description: The tools on this page, by name.
          type: array
          items:
            $ref: '#/components/schemas/AgentToolEntity'
        totalPages:
          type: number
          description: >-
            Total number of pages available based on the page size and total
            count
          example: 1
      required:
        - data
        - totalPages
    AgentToolEntity:
      type: object
      properties:
        name:
          type: string
          description: The tool's name.
          example: send_payment
        title:
          type: string
          description: The tool's display title, when its server gives one.
          example: Send a payment
        service:
          type:
            - string
            - 'null'
          description: >-
            The service the tool is in, as the agent named it (an MCP server or
            its host); null when it named none.
          example: Stripe
        description:
          type: string
          description: The tool's description.
          example: Sends a payment to a payee.
        inputSchema:
          type: object
          description: The tool's input, as a JSON Schema.
        outputSchema:
          type: object
          description: The tool's output, as a JSON Schema, when its server gives one.
        annotations:
          type: object
          description: >-
            The labels its server gives it (MCP annotations: `readOnlyHint`,
            `destructiveHint`, `idempotentHint`, `openWorldHint`, …).
        risk:
          description: Its risk, as the classifier assessed its definition.
          allOf:
            - $ref: '#/components/schemas/AgentToolRiskEntity'
      required:
        - name
        - service
        - risk
    AgentToolRiskEntity:
      type: object
      properties:
        status:
          type: string
          description: >-
            `done` with a level; `pending` while it is assessed; `failed` when
            it could not be.
          enum:
            - done
            - pending
            - failed
          example: done
        level:
          type: number
          description: '`done`: the level, from 1 (lowest) to 10.'
          example: 4
        reasons:
          description: '`done`: the reasons behind the level, in words.'
          example:
            - Moves money
          type: array
          items:
            type: string
        stale:
          type: boolean
          description: >-
            `done`: from an earlier question set, while the current one
            re-assesses the tool.
          example: false
      required:
        - status

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.