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

# List tools

> Returns tools that match the supplied filters. The serviceId, query, limit, and enabled query parameters are all optional. The enabled filter accepts 'true' or 'false'.



## OpenAPI

````yaml /cyrnel/openapi.json get /tools
openapi: 3.0.0
info:
  title: Cyrnel API
  description: >-
    Cyrnel is a universal layer that connects AI agents and LLM applications to
    any external service, API, or device regardless of protocol or standard. It
    acts as an adaptive bridge between your AI and the outside world, enabling
    seamless integrations through code execution, async operation handling, and
    built-in observability and security controls.
  version: 1.0.0
servers:
  - url: http://localhost:9371
security: []
paths:
  /tools:
    get:
      tags:
        - Tools
      summary: List tools
      description: >-
        Returns tools that match the supplied filters. The serviceId, query,
        limit, and enabled query parameters are all optional. The enabled filter
        accepts 'true' or 'false'.
      parameters:
        - schema:
            type: string
            description: Optional service identifier used to scope tool results.
          required: false
          description: Optional service identifier used to scope tool results.
          name: serviceId
          in: query
        - schema:
            type: string
            description: Free-text query used to match tool names and descriptions.
          required: false
          description: Free-text query used to match tool names and descriptions.
          name: query
          in: query
        - schema:
            type: string
            description: >-
              Maximum number of matching tools to return, as a positive integer
              string.
          required: false
          description: >-
            Maximum number of matching tools to return, as a positive integer
            string.
          name: limit
          in: query
        - schema:
            type: string
            enum:
              - 'true'
              - 'false'
            description: Enabled-state filter. Omit to return all tools.
          required: false
          description: Enabled-state filter. Omit to return all tools.
          name: enabled
          in: query
      responses:
        '200':
          description: Matching tools.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ToolListResponse'
        '400':
          description: One or more query parameters could not be parsed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorResponse'
        '401':
          description: A bearer token was required but missing or invalid.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorResponse'
        '500':
          description: The tool list could not be loaded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorResponse'
components:
  schemas:
    ToolListResponse:
      type: object
      properties:
        tools:
          type: array
          items:
            $ref: '#/components/schemas/ToolListItem'
          description: Tools that match the supplied filters.
      required:
        - tools
      description: Collection wrapper for tool listings.
    ApiErrorResponse:
      type: object
      properties:
        error:
          type: string
          description: Human-readable error message returned by the API.
      required:
        - error
      description: Standard error envelope returned by the HTTP error middleware.
    ToolListItem:
      type: object
      properties:
        serviceId:
          type: string
          minLength: 1
          description: Identifier of the service that owns the tool.
        id:
          type: string
          minLength: 1
          description: Tool identifier exposed by the service manifest.
        name:
          type: string
          minLength: 1
          description: Display name declared by the tool definition.
        description:
          type: string
          description: Human-readable tool description.
        enabled:
          type: boolean
          description: Whether the tool is enabled at the manifest level.
        effectivelyEnabled:
          type: boolean
          description: >-
            Whether the tool is callable after accounting for its parent service
            state.
      required:
        - serviceId
        - id
        - name
        - description
        - enabled
        - effectivelyEnabled
      description: Tool summary returned by the tool listing endpoint.

````