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

# List each tool's native tags and declared visibility

> The per-tool native-``tags`` map plus the plugin-declared visibility — one
``{name, tags, hidden}`` entry per registered tool, ``tags`` sorted for a stable
wire order. ``hidden`` is the tool's OWN declaration, read from the FastMCP
``meta`` under the namespaced ``tai42/hidden`` key (a tool that never declared it
is not hidden). The tool_meta overlay's tri-state override is merged on top
client-side; this read exposes only the declaration. Additive to the flat names
contract; a tool with no tags carries an empty list.



## OpenAPI

````yaml /openapi.json get /api/tools/tags
openapi: 3.1.0
info:
  description: The operator HTTP surface served under /api/*.
  title: tai42-skeleton API
  version: 0.3.0
servers: []
security: []
paths:
  /api/tools/tags:
    get:
      tags:
        - tools
      summary: List each tool's native tags and declared visibility
      description: >-
        The per-tool native-``tags`` map plus the plugin-declared visibility —
        one

        ``{name, tags, hidden}`` entry per registered tool, ``tags`` sorted for
        a stable

        wire order. ``hidden`` is the tool's OWN declaration, read from the
        FastMCP

        ``meta`` under the namespaced ``tai42/hidden`` key (a tool that never
        declared it

        is not hidden). The tool_meta overlay's tri-state override is merged on
        top

        client-side; this read exposes only the declaration. Additive to the
        flat names

        contract; a tool with no tags carries an empty list.
      operationId: get_api_tools_tags
      responses:
        '200':
          content:
            application/json:
              schema:
                properties:
                  data: {}
                required:
                  - data
                type: object
          description: Success.
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Missing or invalid api key.
      security:
        - ApiKeyAuth: []
components:
  schemas:
    Error:
      properties:
        error:
          type: string
      required:
        - error
      type: object
  securitySchemes:
    ApiKeyAuth:
      in: header
      name: x-api-key
      type: apiKey

````