# `smallforce calls tools test`

Send a real request with the given inputs and show what the AI would hear

This page is generated from the same Commander definition shipped in SmallForce CLI 0.1.13. Run `smallforce calls tools test --help` locally to view the same reference for your installed version.

## Complete command help

```text
Usage: smallforce calls tools test [options] <toolId>

Send a real request with the given inputs and show what the AI would hear

Options:
  --api-key <key>            SmallForce API key, or set SMALLFORCE_API_KEY
  --backend-url <url>        SmallForce backend URL, or set SMALLFORCE_BACKEND_URL
  --json                     Print stable machine-readable JSON
  --text                     Print human-readable text
  --format <format>          Output format: text or json
  --inputs <json>            The inputs as a JSON object, e.g. '{"order_number":"1042"}'
  --caller-phone <e164>      Pretend caller phone, e.g. +15551234567
  --caller-confirmed         Treat the caller's number as confirmed by their phone company
  --assistant <assistantId>  Fill receptionist name and time zone from this receptionist
  -h, --help                 display help for command
```

## Related reference

- [`smallforce calls tools`](/docs/cli/commands/calls/tools): Parent command and related operations.
- [CLI installation and authentication](/docs/cli/getting-started): Install the CLI and configure an API key.
- [CLI JSON output](/docs/cli/json-output): Use stable machine-readable output in scripts and agents.