---
title: "Tool reference"
description: "Every tool in the Speak AI MCP server, grouped by category, with its parameters and behaviour hints on one page each."
---
> Documentation Index
> Fetch the complete documentation index at: https://docs.speakai.co/llms.txt
> Use this file to discover all available pages before exploring further.
# Tool reference
The Speak AI MCP server exposes 112 tools across 15 categories. Every tool has its
own page with a plain-language summary, its parameters, and its behaviour hints.
Every page here is generated from the server itself, so the parameters and
descriptions match the tools your assistant actually calls.
## What does the Media library category cover?
Upload audio or video, fetch transcripts, get AI insights, organize, favorite,
export. The Media library category has 17 tools, each on its own page under
[Media library](/mcp/tools/media/).
- [`update_transcription`](/mcp/tools/media/update_transcription/): Edit the
official transcript text of a single media file by finding and replacing text.
- [`get_signed_upload_url`](/mcp/tools/media/get_signed_upload_url/): Get a
pre-signed S3 URL for direct file upload to Speak AI storage.
- [`upload_media`](/mcp/tools/media/upload_media/): Upload media from a URL: a
direct/public file URL, a pre-signed S3 URL, or a shareable social/video link
(YouTube, Instagram, TikTok, X, Facebook, Reddit, SoundCloud, and similar) which
Speak resolves to the underlying media automatically.
- [`upload_local_file`](/mcp/tools/media/upload_local_file/): Upload a local file to
Speak AI for transcription and analysis.
- [`upload_and_analyze`](/mcp/tools/media/upload_and_analyze/): Upload and
transcribe media from a URL: a direct/public file URL, OR a shareable social/video
link (YouTube, Instagram, TikTok, X, Facebook, Reddit, SoundCloud, and similar),
which Speak resolves to the underlying media automatically.
- [`list_media`](/mcp/tools/media/list_media/): List and search media files in the
workspace with filtering, pagination, and sorting.
- [`get_media_insights`](/mcp/tools/media/get_media_insights/): Retrieve
AI-generated insights for a processed media file: topics, sentiment, keywords,
action items, summaries, and more.
- [`get_transcript`](/mcp/tools/media/get_transcript/): Retrieve the full transcript
for a media file with speaker labels and timestamps.
- [`get_captions`](/mcp/tools/media/get_captions/): Get captions for a media file.
- [`update_transcript_speakers`](/mcp/tools/media/update_transcript_speakers/):
Update or rename speaker labels in a media transcript.
- [`bulk_update_transcript_speakers`](/mcp/tools/media/bulk_update_transcript_speakers/):
Update or rename speaker labels across multiple media files in a single operation.
- [`get_media_status`](/mcp/tools/media/get_media_status/): Check the processing
status of a media file.
- [`update_media_metadata`](/mcp/tools/media/update_media_metadata/): Update
metadata fields (name, description, tags, status) for an existing media file.
- [`delete_media`](/mcp/tools/media/delete_media/): Permanently delete a media file
and all associated transcripts and insights.
- [`toggle_media_favorite`](/mcp/tools/media/toggle_media_favorite/): Mark or unmark
media files as favorites for quick access.
- [`reanalyze_media`](/mcp/tools/media/reanalyze_media/): Re-run AI analysis on a
media file using the latest models.
- [`bulk_move_media`](/mcp/tools/media/bulk_move_media/): Move multiple media files
to a folder in a single operation.
## What does the Ask AI Chat category cover?
Run AI prompts across one file, a folder, or your whole workspace. Save favorites.
The Ask AI Chat category has 12 tools, each on its own page under
[Ask AI Chat](/mcp/tools/magic-prompt/).
- [`ask_ai_chat`](/mcp/tools/magic-prompt/ask_ai_chat/): Ask an AI-powered question
about your media using Speak AI's AI Chat.
- [`retry_ai_chat`](/mcp/tools/magic-prompt/retry_ai_chat/): Retry a failed or
incomplete AI Chat response.
- [`get_chat_history`](/mcp/tools/magic-prompt/get_chat_history/): Get a list of
recent AI Chat conversations.
- [`get_chat_messages`](/mcp/tools/magic-prompt/get_chat_messages/): Get full
message history for conversations.
- [`delete_chat_message`](/mcp/tools/magic-prompt/delete_chat_message/): Delete a
specific chat message from conversation history.
- [`list_prompts`](/mcp/tools/magic-prompt/list_prompts/): List all available AI
Chat templates.
- [`get_favorite_prompts`](/mcp/tools/magic-prompt/get_favorite_prompts/): Get all
prompts and answers that have been marked as favorites.
- [`toggle_prompt_favorite`](/mcp/tools/magic-prompt/toggle_prompt_favorite/): Mark
or unmark a chat message as a favorite for easy retrieval later.
- [`update_chat_title`](/mcp/tools/magic-prompt/update_chat_title/): Update the
title of a chat conversation for easier identification in history.
- [`submit_chat_feedback`](/mcp/tools/magic-prompt/submit_chat_feedback/): Submit
feedback on a chat response (thumbs up/down).
- [`get_chat_statistics`](/mcp/tools/magic-prompt/get_chat_statistics/): Get usage
statistics for AI Chat / chat.
- [`export_chat_answer`](/mcp/tools/magic-prompt/export_chat_answer/): Export a
specific AI Chat answer.
## What does the Search & analytics category cover?
Full-text search across transcripts, insights, and metadata. Workspace-level stats.
The Search & analytics category has 3 tools, each on its own page under
[Search & analytics](/mcp/tools/search-analytics/).
- [`search_media`](/mcp/tools/search-analytics/search_media/): Deep search across
all media transcripts, insights, and metadata.
- [`get_media_statistics`](/mcp/tools/search-analytics/get_media_statistics/): Get
workspace-level media statistics: total counts, processing status breakdown,
storage usage, etc.
- [`list_supported_languages`](/mcp/tools/search-analytics/list_supported_languages/):
List all languages supported for transcription.
## What does the Folders & views category cover?
Create folders, save filtered views, bulk move files, share read-only collections.
The Folders & views category has 11 tools, each on its own page under
[Folders & views](/mcp/tools/folders-views/).
- [`list_folders`](/mcp/tools/folders-views/list_folders/): List all folders in the
workspace with pagination and sorting.
- [`get_folder_info`](/mcp/tools/folders-views/get_folder_info/): Get detailed
information about a specific folder including its contents.
- [`create_folder`](/mcp/tools/folders-views/create_folder/): Create a new folder in
the workspace.
- [`clone_folder`](/mcp/tools/folders-views/clone_folder/): Duplicate an existing
folder and all of its contents.
- [`update_folder`](/mcp/tools/folders-views/update_folder/): Update a folder.
- [`delete_folder`](/mcp/tools/folders-views/delete_folder/): Permanently delete a
folder.
- [`get_all_folder_views`](/mcp/tools/folders-views/get_all_folder_views/): Retrieve
all saved views across all folders.
- [`get_folder_views`](/mcp/tools/folders-views/get_folder_views/): Retrieve all
saved views for a specific folder.
- [`create_folder_view`](/mcp/tools/folders-views/create_folder_view/): Create a new
saved view for a folder with a custom set of display columns.
- [`update_folder_view`](/mcp/tools/folders-views/update_folder_view/): Update an
existing saved view.
- [`clone_folder_view`](/mcp/tools/folders-views/clone_folder_view/): Duplicate an
existing folder view into a target folder.
## What does the Recorders & surveys category cover?
Public recording links for clients, prompted question sets, branded submission
pages. The Recorders & surveys category has 10 tools, each on its own page under
[Recorders & surveys](/mcp/tools/recorders-surveys/).
- [`create_recorder`](/mcp/tools/recorders-surveys/create_recorder/): Create a new
recorder or survey for collecting audio/video submissions.
- [`list_recorders`](/mcp/tools/recorders-surveys/list_recorders/): List all
recorders/surveys in the workspace.
- [`get_recorder_info`](/mcp/tools/recorders-surveys/get_recorder_info/): Get
detailed information about a specific recorder including its settings and
questions.
- [`clone_recorder`](/mcp/tools/recorders-surveys/clone_recorder/): Duplicate an
existing recorder including all its settings and questions.
- [`get_recorder_recordings`](/mcp/tools/recorders-surveys/get_recorder_recordings/):
List all submissions/recordings collected by a specific recorder.
- [`generate_recorder_url`](/mcp/tools/recorders-surveys/generate_recorder_url/):
Generate a shareable public URL for a recorder/survey.
- [`update_recorder_settings`](/mcp/tools/recorders-surveys/update_recorder_settings/):
Update configuration settings for a recorder (branding, capture options, etc.).
- [`update_recorder_questions`](/mcp/tools/recorders-surveys/update_recorder_questions/):
Update the survey questions and respondent-info settings for a recorder.
- [`check_recorder_status`](/mcp/tools/recorders-surveys/check_recorder_status/):
Check whether a recorder/survey is active and accepting submissions.
- [`delete_recorder`](/mcp/tools/recorders-surveys/delete_recorder/): Permanently
delete a recorder/survey.
## What does the Clips category cover?
Highlight clips from any time range. Export PDF, DOCX, SRT, VTT, TXT, CSV. The Clips
category has 4 tools, each on its own page under [Clips](/mcp/tools/clips/).
- [`create_clip`](/mcp/tools/clips/create_clip/): Create a highlight clip from one
or more media files by specifying time ranges.
- [`get_clips`](/mcp/tools/clips/get_clips/): List clips, optionally filtered by
folder or media files.
- [`update_clip`](/mcp/tools/clips/update_clip/): Update a clip's title,
description, or tags.
- [`delete_clip`](/mcp/tools/clips/delete_clip/): Permanently delete a clip and its
associated media file.
## What does the Exports category cover?
Highlight clips from any time range. Export PDF, DOCX, SRT, VTT, TXT, CSV. The
Exports category has 2 tools, each on its own page under
[Exports](/mcp/tools/exports/).
- [`export_media`](/mcp/tools/exports/export_media/): Export a media file's
transcript or insights in various formats (pdf, docx, srt, vtt, txt, csv).
- [`export_multiple_media`](/mcp/tools/exports/export_multiple_media/): Export
multiple media files at once, optionally merged into a single file.
## What does the Meeting bot category cover?
Schedule Speak AI to join a Zoom / Google Meet / Teams call and transcribe
automatically. The Meeting bot category has 5 tools, each on its own page under
[Meeting bot](/mcp/tools/meeting-bot/).
- [`list_meeting_events`](/mcp/tools/meeting-bot/list_meeting_events/): List
scheduled or completed meeting assistant events with filtering and pagination.
- [`schedule_meeting_event`](/mcp/tools/meeting-bot/schedule_meeting_event/):
Schedule the Speak AI meeting assistant to join and record an upcoming meeting.
- [`remove_assistant_from_meeting`](/mcp/tools/meeting-bot/remove_assistant_from_meeting/):
Remove the Speak AI assistant from an active or scheduled meeting.
- [`delete_scheduled_assistant`](/mcp/tools/meeting-bot/delete_scheduled_assistant/):
Cancel and delete a scheduled meeting assistant event.
- [`get_live_meeting_transcript`](/mcp/tools/meeting-bot/get_live_meeting_transcript/):
Fetch new sentences from an in-progress or just-ended meeting transcript.
## What does the Automations category cover?
Trigger actions on new recordings. Send events to your own backend. The Automations
category has 15 tools, each on its own page under
[Automations](/mcp/tools/automations/).
- [`list_automations`](/mcp/tools/automations/list_automations/): List automation
rules in the workspace, with paging and filters.
- [`get_automation`](/mcp/tools/automations/get_automation/): Get detailed
information about a specific automation rule, including its trigger and step
graph.
- [`create_automation`](/mcp/tools/automations/create_automation/): Create a new
automation rule using the V2 graph model (trigger + ordered steps).
- [`update_automation`](/mcp/tools/automations/update_automation/): Update an
existing automation rule.
- [`toggle_automation_status`](/mcp/tools/automations/toggle_automation_status/):
Toggle an automation rule between active and inactive.
- [`list_automation_names`](/mcp/tools/automations/list_automation_names/): List
automations as lightweight \{ name, id \} pairs: useful for pickers without
fetching full configs.
- [`get_automation_runs`](/mcp/tools/automations/get_automation_runs/): Get the run
history (executions) for an automation, with paging and optional status filter.
- [`bulk_update_automation_status`](/mcp/tools/automations/bulk_update_automation_status/):
Activate or deactivate multiple automations at once.
- [`bulk_assign_automation_folders`](/mcp/tools/automations/bulk_assign_automation_folders/):
Set the folder scope for multiple automations at once.
- [`run_automations`](/mcp/tools/automations/run_automations/): Manually run one or
more automations against one or more media items now (outside the normal trigger).
- [`delete_automation`](/mcp/tools/automations/delete_automation/): Permanently
delete an automation rule.
- [`list_automation_apps`](/mcp/tools/automations/list_automation_apps/): List the
apps available in the automation catalog (e.g. Speak native + connected
integrations).
- [`list_automation_triggers`](/mcp/tools/automations/list_automation_triggers/):
List the trigger types available in the automation catalog.
- [`list_automation_actions`](/mcp/tools/automations/list_automation_actions/): List
the action/step types available in the automation catalog.
- [`build_automation`](/mcp/tools/automations/build_automation/): High-level
automation builder: create (or update) a Speak automation from a friendly spec
without knowing the wire format.
## What does the Webhooks category cover?
Trigger actions on new recordings. Send events to your own backend. The Webhooks
category has 7 tools, each on its own page under [Webhooks](/mcp/tools/webhooks/).
- [`create_webhook`](/mcp/tools/webhooks/create_webhook/): Create a new webhook to
receive real-time notifications when events occur in Speak AI.
- [`list_webhooks`](/mcp/tools/webhooks/list_webhooks/): List all configured
webhooks in the workspace.
- [`update_webhook`](/mcp/tools/webhooks/update_webhook/): Update an existing
webhook.
- [`delete_webhook`](/mcp/tools/webhooks/delete_webhook/): Delete a webhook and stop
receiving notifications at its endpoint.
- [`provision_inbound_webhook`](/mcp/tools/webhooks/provision_inbound_webhook/):
Provision a standalone inbound webhook and get its public receive URL (inboundUrl)
BEFORE creating an automation.
- [`get_inbound_webhook`](/mcp/tools/webhooks/get_inbound_webhook/): Get an inbound
webhook's public receive URL, captured sample payload, and the ready-to-paste
\{\{trigger.payload.*\}\} tokens for mapping payload values into automation steps
(speak-upload name/sourceUrl, fieldsMap custom-field values,
notify/outbound-webhook templates).
- [`get_webhook_attempts`](/mcp/tools/webhooks/get_webhook_attempts/): Get the
delivery log for an inbound webhook: each received request with its HTTP
acknowledgement status (200 = sample captured, 202 = accepted and run started,
401/403 = rejected) and the automation run it started.
## What does the Text notes category cover?
Standalone AI-analyzed text notes plus custom fields you can tag any media file
with. The Text notes category has 4 tools, each on its own page under
[Text notes](/mcp/tools/text-notes/).
- [`create_text_note`](/mcp/tools/text-notes/create_text_note/): Create a new text
note in Speak AI for analysis.
- [`get_text_insight`](/mcp/tools/text-notes/get_text_insight/): Retrieve
AI-generated insights for a text note, including topics, sentiment, summaries, and
action items.
- [`reanalyze_text`](/mcp/tools/text-notes/reanalyze_text/): Trigger a re-analysis
of an existing text note to regenerate insights with the latest AI models.
- [`update_text_note`](/mcp/tools/text-notes/update_text_note/): Update an existing
text note's name, content, or metadata.
## What does the Custom fields category cover?
Standalone AI-analyzed text notes plus custom fields you can tag any media file
with. The Custom fields category has 4 tools, each on its own page under
[Custom fields](/mcp/tools/custom-fields/).
- [`list_fields`](/mcp/tools/custom-fields/list_fields/): List all custom fields
defined in the workspace.
- [`create_field`](/mcp/tools/custom-fields/create_field/): Create a new custom
field for categorizing and tagging media.
- [`update_field`](/mcp/tools/custom-fields/update_field/): Update a specific custom
field by ID.
- [`update_multiple_fields`](/mcp/tools/custom-fields/update_multiple_fields/): Set
custom field values across media in a single batch operation.
## What does the Embed players category cover?
Embeddable player widgets for media on your own website. The Embed players category
has 4 tools, each on its own page under [Embed players](/mcp/tools/embed-other/).
- [`create_embed`](/mcp/tools/embed-other/create_embed/): Create an embeddable
player/transcript widget for a media file or a set of folders.
- [`update_embed`](/mcp/tools/embed-other/update_embed/): Update an existing embed
widget: appearance/feature toggles via `meta`, plus scope and privacy.
- [`check_embed`](/mcp/tools/embed-other/check_embed/): Check if an embed exists for
a media file and retrieve its configuration.
- [`get_embed_iframe_url`](/mcp/tools/embed-other/get_embed_iframe_url/): Get the
iframe URL for embedding a media player/transcript on a webpage.
## What does the Users & teams category cover?
List workspace members and manage user groups. The Users & teams category has 5
tools, each on its own page under [Users & teams](/mcp/tools/users-team/).
- [`list_users`](/mcp/tools/users-team/list_users/): List the users (members) in the
workspace/company, with their ids, names, emails, and permissions.
- [`list_user_groups`](/mcp/tools/users-team/list_user_groups/): List all user
groups in the company.
- [`create_user_group`](/mcp/tools/users-team/create_user_group/): Create a new user
group and assign members.
- [`update_user_group`](/mcp/tools/users-team/update_user_group/): Update a user
group's name and member list.
- [`delete_user_group`](/mcp/tools/users-team/delete_user_group/): Delete a user
group.
## What does the Dashboards category cover?
Create and manage analytics dashboards, widgets, and public sharing. The Dashboards
category has 9 tools, each on its own page under
[Dashboards](/mcp/tools/dashboards/).
- [`list_dashboard_widgets`](/mcp/tools/dashboards/list_dashboard_widgets/):
Discovery + how-to helper for building and customizing dashboards.
- [`list_dashboards`](/mcp/tools/dashboards/list_dashboards/): List all analytics
dashboards the caller can access, including share state and each dashboard's
current `revision` (needed for `update_dashboard`).
- [`get_dashboard`](/mcp/tools/dashboards/get_dashboard/): Get a single dashboard's
full spec: title, description, source, date range, sections, widgets, and the
current `revision` (pass that revision back to `update_dashboard`).
- [`create_dashboard`](/mcp/tools/dashboards/create_dashboard/): Create an analytics
dashboard.
- [`update_dashboard`](/mcp/tools/dashboards/update_dashboard/): Update a dashboard.
- [`delete_dashboard`](/mcp/tools/dashboards/delete_dashboard/): Soft-delete a
dashboard.
- [`duplicate_dashboard`](/mcp/tools/dashboards/duplicate_dashboard/): Clone an
existing dashboard.
- [`share_dashboard`](/mcp/tools/dashboards/share_dashboard/): Enable public sharing
for a dashboard and return its share token + embed id.
- [`get_dashboard_speakers_insight`](/mcp/tools/dashboards/get_dashboard_speakers_insight/):
Compute a speakers breakdown for a given folder scope, date range, and field
filters.
## Related
- [MCP server](/mcp/) covers setup, supported clients, and what agents can do once
connected.
Source: https://docs.speakai.co/mcp/tools/index.mdx