Docs Reference
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 allow, so tools/list is always the truth for a given connection.
| Area | What its tools do |
|---|---|
| Workspace and flows | Orient the app: who it is, what it may do, the workspace’s stages, and what changed. |
| Search | Find a moment by what was said or shown, or a page by what is written on it. |
| Files | List files, read what is inside them, upload new ones and new versions. |
| Folders | Browse, create and rename Drive folders. |
| Documents | Read a Soontra document’s text, and create new ones. |
| Projects | List, create and update projects, and link files to them. |
| Subtasks | A project’s checklist: list, add, update and complete. |
| Comments | Read and add comments on a project. |
| Posts | Read posts, and create or edit drafts. Publishing stays with a person. |
| Analytics | Views, likes, comments and audience figures for connected channels. |
| Links | List the links saved in the workspace. |
| Notifications | Read notifications and mark them read. |
| Members | See who is in the workspace and their roles. |
How tools behave
- Results are JSON, returned as text content. Each carries a
_noticefield 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_keyso a retry cannot repeat the write. See Errors. - Unknown arguments are rejected, so a misspelled parameter fails instead of being ignored.
- Drive tools work on the Team drive unless
drive_scopesayspersonalorshared. - 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.