---
title: "List tools"
method: GET
path: "/tools"
---

# List tools

`GET /tools`

Returns a list of tool definitions.

## Request body

- object
  - `$schema` string, uri

## Response `200`

A list of available tools.

- object
  - `$schema` string, uri
  - `items` ToolDefinition[], required
    - `id` string, required — A tool's unique identifier in the format 'Toolkit.Tool[@version]', where @version is optional.
    - `name` string, required — The tool's name. Only allows alphanumeric characters, underscores, and dashes.
    - `description` string, required — A plain language explanation of when and how the tool should be used.
    - `version` string, required — A tool's semantic version in the format 'x.y.z', where x, y, and z are integers.
    - `input_schema` object — JSON Schema describing the input parameters for the tool. Supports standard JSON Schema validation but excludes $ref and definitions/schemas for simplicity.
    - `output_schema` object, nullable — JSON Schema describing the output parameters for the tool. Supports standard JSON Schema validation but excludes $ref and definitions/schemas for simplicity.
    - `requirements` object
      - `authorization` object[]
        - `id` string — A provider's unique identifier, allowing the tool to specify a specific authorization provider.
        - `oauth2` object — OAuth 2.0-specific authorization details.
          - `scopes` string[]
      - `secrets` object[]
        - `id` string, required — The secret's unique identifier.
      - `user_id` boolean — Whether the tool requires a user ID.

## Other responses

- `401` — Unauthorized. The request requires authentication, but the provided credentials are invalid or missing.

---

[API](https://skmtc.net/openexecprotocol/apis/open-execution-protocol-oxp-standard.md) · [All operations](https://skmtc.net/openexecprotocol/apis/open-execution-protocol-oxp-standard/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/openexecprotocol/open-execution-protocol-oxp-standard/versions/40d99ea9c623/schema)