# Get tool

`GET /v1/tools/{tool}`, operation `tools.GetTool`

Gets a tool.

## Parameters

| Name | In | Required | Type | Description |
| --- | --- | --- | --- | --- |
| `tool` | path | Yes | `string` | The tool's ID, such as web_search. |

## Responses

### 200

OK

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `description` | `string` | Yes | What the tool does. |
| `displayName` | `string` | Yes | Name shown in user interfaces. |
| `inputSchema` | `string` | Yes | A JSON Schema for its calls' input, as JSON text, for software that answers a client tool's calls. |
| `kind` | `string` | Yes | Who carries out its calls: SERVER, kosem, while the agent waits; CLIENT, a person, or software watching the agent, which the agent waits for the answer of, sent as an answer event. Values: `SERVER`, `CLIENT`. |
| `name` | `string` | Yes | Resource name, such as tools/web_search. The last part is the tool's ID, which agents' configs and settings name it by, and the name the model calls it by. |

### default

Error

Base URL: `https://api.kosem.ai`. See [API conventions](https://docs.kosem.ai/reference/api-conventions.md) for authentication, pagination and errors, and [https://docs.kosem.ai/openapi.yaml](https://docs.kosem.ai/openapi.yaml) for the full OpenAPI document.