Use the Speak AI MCP server tool upload_and_analyze to 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.
What does it do?
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. Returns
media_id immediately; after this returns, poll get_media_status until state is
‘processed’ (typically 1-3 min for under 60min audio), then call
get_media_insights for AI summaries. This async pattern is required for remote MCP
transports: long blocking calls die at proxy idle timeouts. (Vimeo links are not yet
supported.)
Parameters
upload_and_analyze takes 6 parameters, 1 of them required.
| Name | Type | Required | Description |
|---|---|---|---|
url |
string | Yes | Direct/public media file URL, or a shareable social/video page link (e.g. an Instagram reel, TikTok, YouTube, or X post URL): page links are resolved to the underlying media server-side. Pass the URL the user gave you as-is. |
name |
string | No | Display name for the media (defaults to filename from URL) |
mediaType |
enum | No | Media type (default: audio) |
sourceLanguage |
string | No | BCP-47 language code (e.g., ‘en-US’, ‘he-IL’) |
folderId |
string | No | Folder ID to place the media in |
tags |
string | No | Comma-separated tags |
Behaviour
The Speak AI MCP server publishes these behaviour hints for upload_and_analyze.
- Can change data in your workspace.
- Does not delete or overwrite existing data.
- Repeating an identical call can have an extra effect.
- Can reach systems outside Speak AI.
Related
- Media library lists the rest of the Media library category.
- Tool reference lists every Speak AI MCP server tool.
- MCP server covers setup, supported clients, and what agents can do once connected.