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 page link, 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 page link, which Speak resolves to the underlying media automatically.
Supported page links: YouTube, TikTok, Instagram, X/Twitter, Facebook, Reddit,
SoundCloud, Twitch, Dailymotion, Streamable, Snapchat, Pinterest, Tumblr, Bilibili,
VK, OK.ru and Rutube. Vimeo and Loom page links are not supported. 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.
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: page links are resolved to the underlying media server-side. See this tool’s description for the platforms accepted. Pass the URL the user gave you as-is; do not try to convert it to a file URL first. |
name |
string | No | Display name for the media (defaults to filename from URL) |
mediaType |
enum | No | Type of media: “audio” or “video”. Send it whenever the user has told you which they want: if they called it an audio file, or asked for audio only, pass “audio”; if they called it a video, pass “video”. Otherwise omit it and the server decides: it inspects the actual file for a direct URL, and picks the best track the platform offers for a page link. Do not guess from the URL, because sending a value stops the server inspecting the file, and a video imported as “audio” can never be analysed as video afterwards. |
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.