> ## 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, declared visibility, and badges

> The per-tool native-``tags`` map plus the plugin-declared visibility and
capability badges — one ``{name, tags, hidden, badges}`` entry per registered
tool, ``tags`` and ``badges`` each 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); ``badges`` is
likewise the tool's OWN declared INFORMATIONAL capability badges, read from
``meta`` under ``tai42/badges`` (a tool that declared none carries an empty list).
The tool_meta overlay's tri-state override and its own badge set are 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: 14.0.2
servers: []
security: []
paths:
  /api/tools/tags:
    get:
      tags:
        - tools
      summary: List each tool's native tags, declared visibility, and badges
      description: >-
        The per-tool native-``tags`` map plus the plugin-declared visibility and

        capability badges — one ``{name, tags, hidden, badges}`` entry per
        registered

        tool, ``tags`` and ``badges`` each 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);
        ``badges`` is

        likewise the tool's OWN declared INFORMATIONAL capability badges, read
        from

        ``meta`` under ``tai42/badges`` (a tool that declared none carries an
        empty list).

        The tool_meta overlay's tri-state override and its own badge set are
        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:
                    $ref: '#/components/schemas/ToolTagListResponse'
                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:
    ToolTagListResponse:
      description: The bare array of per-tool tag rows.
      items:
        $ref: '#/components/schemas/ToolTagRow'
      title: ToolTagListResponse
      type: array
    Error:
      properties:
        code:
          description: >-
            Stable machine-readable reason a client keys a dedicated error state
            on, present on refusals that opt in (e.g. a 501 not-configured
            refusal). Optional: absent when the error carries only a
            human-readable message.
          type: string
        error:
          type: string
      required:
        - error
      type: object
    ToolTagRow:
      description: >-
        One tool's declared tags, visibility, and capability badges. ``hidden``
        and

        ``badges`` are the tool's OWN declaration (before the tool_meta
        overlay's

        override).
      properties:
        badges:
          items:
            type: string
          title: Badges
          type: array
        hidden:
          title: Hidden
          type: boolean
        name:
          title: Name
          type: string
        tags:
          items:
            type: string
          title: Tags
          type: array
      required:
        - name
        - tags
        - hidden
        - badges
      title: ToolTagRow
      type: object
  securitySchemes:
    ApiKeyAuth:
      in: header
      name: x-api-key
      type: apiKey

````