Use the Speak AI MCP server tool upload_and_analyze_batch to import up to 25 audio
or video URLs in one call.
What does it do?
Import up to 25 audio or video URLs in one call. Each URL is imported the same way
as upload_and_analyze, and transcription starts for each one. At most 5 uploads
run at once. Each URL may be a direct public file URL or a page link from a
supported platform, which the server resolves to the underlying media. 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. Each accepted upload
creates a media item and bills its duration against the workspace’s minutes or
credits. A failed URL does not stop the others, and the result lists every URL as
uploaded (with its mediaId) or failed (with the reason). Returns once the uploads
are accepted. Use get_media_status per mediaId, or list_media on the folder, to
follow processing.
Parameters
upload_and_analyze_batch takes 6 parameters, 1 of them required.
| Name | Type | Required | Description |
|---|---|---|---|
urls |
array of string | Yes | The URLs to import, up to 25. Pass each one exactly as the user gave it; page links are resolved server-side. Exact duplicate URLs are sent once. |
mediaType |
enum | No | Applies to every URL in the batch. Send it only when the user has said which they want for all of them: “audio” if they asked for audio only, “video” if they called them videos. Otherwise omit it and the server decides per URL. Mixed batches: leave it off, or split into two calls. |
folderId |
string | No | Folder ID for every upload in the batch |
sourceLanguage |
string | No | BCP-47 language code applied to every upload, e.g. “en-US” |
tags |
string | No | Comma-separated tags applied to every upload |
concurrency |
number | No | How many uploads to start at once, 1 to 5. Defaults to 5. Drop it to 1 to import strictly in order. |
Behaviour
The Speak AI MCP server publishes these behaviour hints for
upload_and_analyze_batch.
- Can change data in your workspace.
- Can delete or overwrite data. Use with care.
- Repeating an identical call can have an extra effect.
- Can reach systems outside Speak AI.
Related
- Media lists the rest of the Media category.
- Tool reference lists every Speak AI MCP server tool.
- MCP server covers setup, supported clients, and what agents can do once connected.