Skip to content

Tool reference

Every tool in the Speak AI MCP server, grouped by category, with its parameters and behaviour hints on one page each.

Updated View as MarkdownAsk ClaudeOpen in ChatGPTllms.txt

The Speak AI MCP server exposes 189 tools across 18 categories. Every tool has its own page with a plain-language summary, its parameters, and its behaviour hints.

These pages are generated from the server’s own tool manifest and its input schemas, so they change when the server changes. Fix a wrong description in the speak-mcp repo, not here.

Showing 189 of 189 tools.

What does the Media category cover?

Upload audio or video, fetch transcripts, get AI insights, organize, favorite, export. The Media category has 19 tools, each on its own page under Media.

  • update_transcription: Edit the official transcript text of a single media file by finding and replacing text.
  • get_signed_upload_url: Get a pre-signed S3 URL for direct file upload to Speak AI storage.
  • upload_media: Import an audio or video file into Speak AI from a URL and start transcription.
  • upload_local_file: Upload a local file to Speak AI for transcription and analysis.
  • upload_and_analyze: Upload and transcribe media from a URL: a direct/public file URL, OR a shareable social/video page link, which Speak resolves to the underlying media automatically.
  • list_media: List and search media files in the workspace with filtering, pagination, and sorting.
  • get_media_insights: Retrieve AI-generated insights for a processed media file: topics, sentiment, keywords, action items, summaries, and more.
  • get_transcript: Retrieve the full transcript for a media file with speaker labels and timestamps.
  • get_captions: Get captions for a media file.
  • update_transcript_speakers: Update or rename speaker labels in a single media transcript.
  • bulk_update_transcript_speakers: Normalise speaker names that are ALREADY correct across multiple media files: for example changing “Frederik S.” to “Frederik” everywhere.
  • get_media_status: Check the processing status of a media file.
  • update_media_metadata: Update metadata fields (name, description, tags, status) for an existing media file.
  • delete_media: Permanently delete a media file and all associated transcripts and insights.
  • toggle_media_favorite: Mark or unmark media files as favorites for quick access.
  • reanalyze_media: Re-run AI analysis on a media file using the latest models.
  • bulk_move_media: Move multiple media files to a folder in a single operation.
  • upload_and_analyze_batch: Import up to 25 audio or video URLs in one call.
  • set_media_thumbnail: Set a custom thumbnail for a video.

What does the AI Chat category cover?

Run AI prompts across one file, a folder, or your whole workspace. Save favorites. The AI Chat category has 13 tools, each on its own page under AI Chat.

  • ask_ai_chat: Ask an AI-powered question about your media using Speak AI’s AI Chat.
  • retry_ai_chat: Retry a failed or incomplete AI Chat response.
  • get_chat_history: Get a list of recent AI Chat conversations.
  • get_chat_messages: Get full message history for conversations.
  • delete_chat_conversation: Delete an entire chat conversation from conversation history, so it and its messages no longer appear.
  • list_prompts: List recent AI Chat messages across the workspace, newest first, with each prompt, answer, references, and the media or folder it ran on.
  • get_favorite_prompts: Get all prompts and answers that have been marked as favorites.
  • toggle_prompt_favorite: Mark or unmark a chat message as a favorite for easy retrieval later.
  • update_chat_title: Update the title of a chat conversation for easier identification in history.
  • submit_chat_feedback: Submit feedback on a chat response (thumbs up/down).
  • get_chat_statistics: Get usage statistics for AI Chat / chat.
  • export_chat_answer: Export a specific AI Chat answer.
  • get_analysis_quote: Check whether a media file can be analysed as audio or video, and what it will cost, before running ask_ai_chat with analysisInput.

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.

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.

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.

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.

  • create_clip: Create a highlight clip from one or more media files by specifying time ranges.
  • get_clips: List clips, optionally filtered by folder or media files.
  • update_clip: Update a clip’s title, description, or tags.
  • 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.

  • export_media: Export a media file’s transcript, insights or labels in various formats (pdf, docx, srt, vtt, txt, csv).
  • export_multiple_media: Export multiple media files at once, optionally merged into a single file.

What does the Meeting assistant category cover?

Schedule Speak AI to join a Zoom / Google Meet / Teams call and transcribe automatically. The Meeting assistant category has 5 tools, each on its own page under Meeting assistant.

What does the Automations category cover?

Trigger actions on new recordings. Send events to your own backend. The Automations category has 20 tools, each on its own page under Automations.

  • list_automations: List automation rules in the workspace, with paging and filters.
  • get_automation: Get detailed information about a specific automation rule, including its trigger and step graph.
  • create_automation: Create an automation: a trigger plus ordered steps (V2 graph model).
  • update_automation: Update an existing automation rule.
  • toggle_automation_status: Toggle an automation rule between active and inactive.
  • list_automation_names: List the names and ids of active automations that contain an AI chat (magic prompt) step.
  • get_automation_runs: Get the run history (executions) for an automation, with paging and optional status filter.
  • bulk_update_automation_status: Activate or deactivate multiple automations at once.
  • bulk_assign_automation_folders: Set the folder scope for multiple automations at once.
  • run_automations: Manually run one or more automations against one or more media items now (outside the normal trigger).
  • delete_automation: Permanently delete an automation rule.
  • list_automation_apps: List the apps in Speak’s automation catalog: Speak’s built-in apps plus, when enabled, third-party apps available through Composio, each marked connected or not_connected for this user.
  • list_automation_triggers: List the trigger types available in the automation catalog.
  • list_automation_actions: List the step types (actions) available in Speak’s automation catalog, optionally for one app slug, plus the fields each filter or condition step can test.
  • build_automation: High-level automation builder: create (or update) a Speak automation from a friendly spec without knowing the wire format.
  • get_automation_run: Get one automation run in full: every step, in dependency order, with what it produced and why it stopped.
  • get_automation_run_stats: Aggregate run counts for an automation over a period: how many completed, failed, or were stopped.
  • test_automation: Run one automation once against one media item to see which way it branches.
  • validate_automation_graph: Check a step graph without saving anything.
  • describe_automation_graph: Show a saved automation’s steps as an indented branch tree instead of a flat list.

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.

  • create_webhook: Create an outbound webhook.
  • list_webhooks: List all configured webhooks in the workspace.
  • update_webhook: Update an existing webhook.
  • delete_webhook: Permanently delete an outbound webhook and its delivery attempt history; its endpoint stops receiving notifications.
  • provision_inbound_webhook: Provision a standalone inbound webhook and get its public receive URL (inboundUrl) BEFORE creating an automation.
  • 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: 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.

  • create_text_note: Create a new text note in Speak AI for analysis.
  • get_text_insight: Retrieve AI-generated insights for a text note, including topics, sentiment, summaries, and action items.
  • reanalyze_text: Trigger a re-analysis of an existing text note to regenerate insights with the latest AI models.
  • update_text_note: Update an existing text note’s name, content, or metadata.

What does the Fields category cover?

Define the fields you tag media files with, and set their values. The Fields category has 4 tools, each on its own page under Fields.

  • list_fields: List all custom fields defined in the workspace.
  • create_field: Create a new custom field for categorizing and tagging media.
  • update_field: Update a specific custom field by ID.
  • update_multiple_fields: Set custom field values across media in a single batch operation, overwriting existing values.

What does the Labels & comments category cover?

Manage workspace labels, apply them to transcript words, and discuss a file in comment threads. The Labels & comments category has 16 tools, each on its own page under Labels & comments.

  • list_labels: List the workspace’s labels as a tree: groups (isGroup true) carry their labels in labels, and ungrouped labels sit at the top level.
  • create_label: Create a label, or a label group with isGroup true.
  • update_label: Rename, recolor, describe, move or reorder a label or group.
  • archive_label: Archive a label so it can no longer be applied; archiving a group archives its labels too.
  • restore_label: Restore an archived label; restoring a group also restores its archived labels.
  • merge_labels: Merge one label into another: every place the source label is applied moves onto the target (a span that had both keeps one), then the source is archived with mergedInto set.
  • add_speak_label_sets: Add ready-made label groups from Speak: sales_qa (Unprofessional, Slang, Objection, Great moment, Compliance risk), research (Pain point, Motivation, Quote for report, Surprise, Follow-up), meetings (Decision, Action item, Risk, Open question) and transcript_feedback (Wrong split, Misheard word, Wrong speaker, Bad translation).
  • list_media_labels: List the labels applied to a media file’s transcript, in transcript order, with the file’s current transcriptRevision.
  • apply_label: Apply one or more labels to a span of words in a media file’s transcript.
  • update_media_label: Change a labelled span on a transcript.
  • remove_media_label: Remove a labelled span from a transcript.
  • list_media_comments: List the comment threads on a media file, with the file’s current transcriptRevision.
  • add_comment: Add a comment to a media file.
  • update_comment: Edit the text of a comment.
  • resolve_comment: Resolve a comment thread, or reopen it with resolved false.
  • delete_comment: Delete a comment.

What does the Embed players category cover?

Embeddable player widgets for media on your own website. The Embed players category has 7 tools, each on its own page under Embed players.

  • create_embed: Create an embeddable player/transcript widget for a media file or a set of folders.
  • update_embed: Update an existing embed widget: appearance/feature toggles via meta, and privacy.
  • check_embed: Check if an embed exists for a media file and retrieve its configuration.
  • get_embed_iframe_url: Get the iframe URL for embedding a media player/transcript on a webpage.
  • list_embed_sessions: Owner analytics for an embed: list the visits (sessions) to one embed, newest first by default.
  • get_embed_session_summary: Owner analytics for an embed: totals across its visits for a date range.
  • get_embed_session: Owner analytics for an embed: one visit in full.

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.

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.

  • list_dashboard_widgets: Discovery + how-to helper for building and customizing 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: 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: Create an analytics dashboard.
  • update_dashboard: Update a dashboard.
  • delete_dashboard: Soft-delete a dashboard.
  • duplicate_dashboard: Clone an existing dashboard into a new dashboard owned by the caller.
  • share_dashboard: Enable public sharing for a dashboard and return its share token + embed id.
  • get_dashboard_speakers_insight: Compute a speakers breakdown for a given folder scope, date range, and field filters.

What does the Voice agents category cover?

Create and configure voice agents, the questions they ask callers and their test suites, and review their conversations. The Voice agents category has 34 tools, each on its own page under Voice agents.

What does the Voice agent insights category cover?

Review and act on a voice agent’s self-improvement surface: knowledge gaps, FAQ suggestions, instruction gaps, and its knowledge-base resources. The Voice agent insights category has 16 tools, each on its own page under Voice agent insights.

  • list_voice_kb_gaps: List a voice agent’s pending knowledge-base gaps: questions callers asked that the agent answered with low confidence or an explicit “I don’t know,” surfaced automatically after calls.
  • analyze_voice_kb_gaps: Trigger knowledge-base gap analysis over a voice agent’s recent calls.
  • add_voice_kb_gap: Write a knowledge-base gap’s answer into the voice agent’s attached knowledge base as a new document, and mark the gap added.
  • dismiss_voice_kb_gap: Mark a voice agent’s knowledge-base gap dismissed without writing anything to the knowledge base.
  • list_voice_faq_suggestions: List a voice agent’s pending FAQ suggestions: questions multiple callers asked in similar form, clustered and drafted into a reusable question/answer pair.
  • generate_voice_faq_suggestions: Trigger FAQ clustering over a voice agent’s recent calls.
  • add_voice_faq_suggestion: Write an FAQ suggestion’s question/answer into the voice agent’s attached knowledge base as a new document, and mark the suggestion added.
  • update_voice_faq_suggestion: Edit a still-pending FAQ suggestion’s question and/or answer before adding it.
  • dismiss_voice_faq_suggestion: Mark a voice agent’s FAQ suggestion dismissed without writing anything to the knowledge base.
  • list_voice_agent_resources: List the knowledge documents/links a voice agent searches during calls: separate from KB gaps and FAQ suggestions, which are the self-improvement layer that surfaces what an agent is missing, not the content itself.
  • create_voice_agent_resource: Add one document/link to a voice agent’s knowledge base.
  • bulk_create_voice_agent_resources: Add up to 100 documents/links to a voice agent’s knowledge base in one call.
  • update_voice_agent_resource: Partially update a voice agent resource: send at least one field.
  • delete_voice_agent_resource: Soft-delete a voice agent resource: it stops appearing in lists and the agent stops searching it, but the document is not physically removed.
  • analyze_voice_instruction_gaps: Advisory only: compares a voice agent’s current instructions against anchors/original intent/recent call summaries you supply and suggests up to 3 patches.
  • apply_voice_instruction_gap: Insert a suggested instruction patch into a voice agent’s instructions and persist the result.
  • MCP server covers setup, supported clients, and what agents can do once connected.
Navigation

Type to search…

↑↓ navigate↵ selectEsc close