# Tool reference

Every tool the server offers, grouped by what it works on.

Tools are named `soontra_<area>_<verb>`, for example `soontra_files_list`. The server lists only the tools a credential’s [scopes](https://soontra.com/docs/scopes) allow, so `tools/list` is always the truth for a given connection.

| Area | What its tools do |
| --- | --- |
| [Workspace and flows](https://soontra.com/docs/tools/workspace) | Orient the app: who it is, what it may do, the workspace’s stages, and what changed. |
| [Search](https://soontra.com/docs/tools/search) | Find a moment by what was said or shown, or a page by what is written on it. |
| [Files](https://soontra.com/docs/tools/files) | List files, read what is inside them, upload new ones and new versions. |
| [Folders](https://soontra.com/docs/tools/folders) | Browse, create and rename Drive folders. |
| [Documents](https://soontra.com/docs/tools/documents) | Read a Soontra document’s text, and create new ones. |
| [Projects](https://soontra.com/docs/tools/projects) | List, create and update projects, and link files to them. |
| [Subtasks](https://soontra.com/docs/tools/subtasks) | A project’s checklist: list, add, update and complete. |
| [Comments](https://soontra.com/docs/tools/comments) | Read and add comments on a project. |
| [Posts](https://soontra.com/docs/tools/posts) | Read posts, and create or edit drafts. Publishing stays with a person. |
| [Analytics](https://soontra.com/docs/tools/analytics) | Views, likes, comments and audience figures for connected channels. |
| [Links](https://soontra.com/docs/tools/links) | List the links saved in the workspace. |
| [Notifications](https://soontra.com/docs/tools/notifications) | Read notifications and mark them read. |
| [Members](https://soontra.com/docs/tools/members) | See who is in the workspace and their roles. |

## How tools behave

- **Results are JSON**, returned as text content. Each carries a `_notice` field reminding the model that workspace text is data, not instructions.
- **Read tools** are marked `readOnlyHint`. Everything else creates or changes something, and nothing deletes.
- **Write tools** take an optional `idempotency_key` so a retry cannot repeat the write. See [Errors](https://soontra.com/docs/errors).
- **Unknown arguments are rejected**, so a misspelled parameter fails instead of being ignored.
- **Drive tools** work on the Team drive unless `drive_scope` says `personal` or `shared`.
- **The list of tools is fixed for a deployment.** The server does not send `tools/list_changed`; fetch the list again when you reconnect.

## Reading a tool’s entry

Each entry shows the scope the tool needs, whether it reads or writes, its description as the server sends it to the model, its parameters, what comes back, and any limit worth knowing. Parameter and description text is the server’s own.