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

# builtin__try_tool

> Test-runs a drafted tool once, before it's saved.

* Checks the tool file, then asks you to approve the run.
* Runs it on the sample input and records its output shape.

| Available to | Effect |
| - | - |
| Any agent or plan step | Has side effects |

## Input

**input** `object` *required*

Sample input for one run, matching the tool's input\_schema

**yaml** `string` *required*

The whole user tool file

## Output

**is\_error** `boolean`

**problems** `string[]`

**ran** `boolean` *required*

**reason** `string`

**result** `any`

**shape** `object`

```yaml Plan step theme={null}
- id: E1
  tool_name: builtin__try_tool
  input:
    yaml: "{{input.yaml}}"
    input: "{{input.input}}"
```


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