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

> The per-tool description and native ``tags`` plus the plugin-declared visibility and capability badges.

One ``{name, description, tags, hidden, badges, schedulable}`` entry per registered tool, ``tags`` and
``badges`` each sorted for a stable wire order. ``description`` is the tool's own declared description
(null when it declares none). ``hidden`` is the tool's OWN declaration, read from the
FastMCP ``meta`` under ``TOOL_META_HIDDEN`` (a tool that never declared it is
not hidden); ``badges`` is likewise the tool's OWN declared INFORMATIONAL capability badges,
read from ``meta`` under ``TOOL_META_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. ``schedulable`` is whether the tool's
``<name>_schedule_task`` vehicle is registered, so a client never spells the suffix. 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/*. The platform's core routes.
    Plugin routes are published by each plugin.
  title: tai42-skeleton API
  version: 35.0.0
servers: []
security: []
paths:
  /api/tools/tags:
    get:
      tags:
        - tools
      summary: >-
        List each tool's description, native tags, declared visibility, and
        badges
      description: >-
        The per-tool description and native ``tags`` plus the plugin-declared
        visibility and capability badges.


        One ``{name, description, tags, hidden, badges, schedulable}`` entry per
        registered tool, ``tags`` and

        ``badges`` each sorted for a stable wire order. ``description`` is the
        tool's own declared description

        (null when it declares none). ``hidden`` is the tool's OWN declaration,
        read from the

        FastMCP ``meta`` under ``TOOL_META_HIDDEN`` (a tool that never declared
        it is

        not hidden); ``badges`` is likewise the tool's OWN declared
        INFORMATIONAL capability badges,

        read from ``meta`` under ``TOOL_META_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. ``schedulable`` is
        whether the tool's

        ``<name>_schedule_task`` vehicle is registered, so a client never spells
        the suffix. 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 description, tags, visibility, and capability
        badges.


        ``description`` is the tool's own declaration, null when the tool
        declares none.

        ``hidden`` and ``badges`` are the tool's OWN declaration (before the
        tool_meta overlay's override).

        ``schedulable`` is whether the tool's schedule vehicle is registered
        (the scheduling backend's

        ``schedule_task`` extension is attached to it).
      properties:
        badges:
          items:
            type: string
          title: Badges
          type: array
        description:
          anyOf:
            - type: string
            - type: 'null'
          title: Description
        hidden:
          title: Hidden
          type: boolean
        name:
          title: Name
          type: string
        schedulable:
          title: Schedulable
          type: boolean
        tags:
          items:
            type: string
          title: Tags
          type: array
      required:
        - name
        - description
        - tags
        - hidden
        - badges
        - schedulable
      title: ToolTagRow
      type: object
  securitySchemes:
    ApiKeyAuth:
      in: header
      name: x-api-key
      type: apiKey

````

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