Use the Speak AI MCP server tool upload_media to 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.
What does it do?
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.
Processing is asynchronous: after uploading, use get_media_status to poll until
state is ‘processed’ (typically 1-3 minutes for audio under 60 min), then use
get_transcript and get_media_insights to retrieve results. For a single call
that handles everything, use upload_and_analyze instead. For local files, use
upload_local_file. (Vimeo links are not yet supported.)
Parameters
upload_media takes 9 parameters, 3 of them required.
| Name | Type | Required | Description |
|---|---|---|---|
name |
string | Yes | Display name for the media file |
url |
string | Yes | Direct/public media file URL, pre-signed S3 URL, or a shareable social/video page link (e.g. an Instagram reel or TikTok URL): page links are resolved to the underlying media server-side. |
mediaType |
enum | Yes | Type of media: “audio” or “video” |
description |
string | No | Description of the media file |
sourceLanguage |
string | No | BCP-47 language code for transcription, e.g. “en-US” or “he-IL” |
tags |
string | No | Comma-separated tags for the media |
folderId |
string | No | ID of the folder to place the media in |
callbackUrl |
string | No | Webhook callback URL for this specific upload |
fields |
array of object | No | Custom field values to attach to the media |
Behaviour
The Speak AI MCP server publishes these behaviour hints for upload_media.
- 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.