# client.tools

> The tools methods of the morevoice Python SDK: Custom tools assistants can call.

Custom tools assistants can call. These methods are on `client.tools`, where `client` is a `MoreVoice` client (see [the Python SDK](https://docs.morevoice.ai/sdk/python/#connect)). On `AsyncMoreVoice` the same methods are awaited. Each one returns the response object and raises an exception when the API answers with an error.

## `test()`

**Test a custom tool.** Runs a custom tool once with the arguments you give, the way a call runs it: the same request body, signed with your tool signing secret (Standard Webhooks headers; test-mode keys sign with the test secret) and sent through the same network guard. Webhook failures (an HTTP error, a timeout) are reported in the result; a URL that cannot be called at all is a 400.

```python
# client.tools
def test(self, body: _m.ToolsTestBody | Mapping[str, Any] | Unset = UNSET, *, more_voice_version: str | Unset = UNSET, idempotency_key: str | Unset = UNSET) -> _m.ToolTest
```

`client.tools.test()` · `await async_client.tools.test()` · `POST /tools/test` · [API reference](https://docs.morevoice.ai/api/operations/tools_test/)

### Request body

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `arguments` | `object` | no | The arguments, as the model would pass them (default `{}`). |
| `assistant_id` | `string` | no | The assistant whose stored tool (with its stored headers) to test. |
| `tool` | `CustomToolParamsInput` | no | A custom tool as you send it. `headers` are write-only: stored with the assistant, never returned. |
| `tool_name` | `string` | no | The stored tool's name (with `assistant_id`). |

### Returns

`ToolTest`:

| Field | Type | Description |
| --- | --- | --- |
| `object` | `"tool_test"` | Always `tool_test`. |
| `livemode` | `boolean` | `true` in live mode, `false` in test mode. |
| `tool` | `string` | The tool's name. |
| `type` | `"webhook" \| "mock"` | `webhook` tools were called over HTTP (signed); `mock` tools answered their `mock_response`. |
| `ok` | `boolean` | true when the tool answered (a 2xx for webhooks). |
| `duration_ms` | `integer` | How long the tool took. |
| `result` | `any` | What the model would receive: the parsed JSON (or text) of the answer. |
| `error` | `object \| null` | null when `ok`. |

### Example

```python
from morevoice import MoreVoice

client = MoreVoice()  # MOREVOICE_API_KEY from the environment

tool_test = client.tools.test({
    "arguments": {
        "date": "2026-11-04",
    },
    "tool": {
        "headers": {
            "Authorization": "Bearer crm-secret",
        },
        "name": "find_slots",
        "timeout_seconds": 10,
        "url": "https://crm.example.com/voice/tools",
    },
})
print(tool_test)
```