Tools
The full list of tools the server registers, by scope.
The server generates its tools from the gateway's committed manifest, so they never drift from the real routes. There are 34 tools in total: 16 read, 16 write, and 2 wait. By default it advertises 29; the 5 webhook tools are hidden unless you start the server with --allow-webhooks.
Read tools (16)
| Tool | Notes |
|---|---|
whoami | Returns the calling token's scopes. |
list_meetings | Paginated meeting list. |
get_meeting | Single MeetingDto. |
get_transcript | Segments for a meeting. |
get_summary | Summary status and result. |
export_meeting | JSON, Markdown, or plain text. |
search_transcripts | Full-text search across meetings. |
get_config | Read-only view of current config. |
list_jobs | Background job list. |
get_job | Single job status. |
list_devices | Audio input/output devices. |
list_models | Available transcription/summary models. |
get_recording_state | Current recording status. |
list_webhooks | Registered webhooks. Hidden unless --allow-webhooks. |
list_webhook_deliveries | Delivery history for a webhook. Hidden unless --allow-webhooks. |
list_pairings | Paired agent clients. Needs Admin scope even though it's read-only. |
Write tools (16)
| Tool | Notes |
|---|---|
rename_meeting | Updates the meeting title. |
set_summary | Overwrites the summary text. |
regenerate_summary | Kicks off a new summary job. |
set_speaker_labels | Maps cluster keys to display names. |
submit_diarization | Submits diarization results. |
cancel_job | Cancels a running job. |
pause_job | Pauses a running job. |
resume_job | Resumes a paused job. |
retry_job | Retries a failed job. |
start_recording | Needs Record scope. |
stop_recording | Needs Record scope. |
pause_recording | Needs Record scope. |
resume_recording | Needs Record scope. |
create_webhook | Hidden unless --allow-webhooks. |
delete_webhook | Hidden unless --allow-webhooks. |
test_webhook | Hidden unless --allow-webhooks. |
Wait tools (2)
| Tool | Notes |
|---|---|
wait_for_job | Resolves on job.completed, job.failed, or job.cancelled. |
wait_for_recording | Resolves on a recording state change. |
Both consume the gateway's wait streams and resolve on the event or a bounded timeout: 30 seconds by default, capped at 600 seconds, with a small read margin added on top.
These are the MCP tool bounds. The HTTP wait endpoints use their own, longer defaults (see the Events and SSE page). Do not confuse the two.
Scope notes
The four recording tools (start_recording, stop_recording, pause_recording, resume_recording) need the Record scope. list_pairings is read-only but needs Admin. The five webhook tools (list_webhooks, list_webhook_deliveries, create_webhook, delete_webhook, test_webhook) are hidden unless the server is started with --allow-webhooks.
Not exposed
There is no tool to import audio; that upload is HTTP only. There is no tool to set config. The two destructive deletes, deleting a meeting and deleting a pairing, are never registered as tools, in any mode.
The list of tools returned to a client is filtered to the calling token's scopes. If the scope probe itself fails, the server falls back to read-only.
Last updated on