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

# Tool commands

> Commands AI agents use to discover, price, and call tools.

All tool commands require authentication. An AI agent should discover a tool, inspect its contract and price, and only then call it.

## List and search

```bash theme={null}
opentooler tools list [--cursor <cursor>]
opentooler tools search <query> [--cursor <cursor>] [--limit <n>]
```

## Describe and quote

```bash theme={null}
opentooler tools describe <tool> [--version <version>]
opentooler tools quote <tool> --input <json|@file|-> [--version <version>]
```

Agents should treat description output as the canonical source for the current input schema, output schema, price, version, and limits.

## Call

```bash theme={null}
opentooler tools call <tool> \
  --input <json|@file|-> \
  [--version <version>] \
  [--max-price <usd>] \
  [--idempotency-key <key>] \
  [--async] \
  [--timeout <duration>]
```

| Option              | Meaning                                                   |
| ------------------- | --------------------------------------------------------- |
| `--input`           | Required JSON input: inline, `@file`, or `-` for stdin.   |
| `--version`         | Pin a semantic tool version.                              |
| `--max-price`       | Maximum approved price in USD.                            |
| `--idempotency-key` | Use only for controlled recovery of the exact same call.  |
| `--async`           | Return after admission instead of waiting for completion. |
| `--timeout`         | Client wait duration, such as `300s`.                     |

The CLI generates an idempotency key by default and applies a quote-based price guard before admitting an agent's paid call.