Use the Speak AI MCP server tool create_embed to create an embeddable
player/transcript widget for a media file or a set of folders.
What does it do?
Create an embeddable player/transcript widget for a media file or a set of folders.
Provide mediaId for a single-media embed, or folderIds for a folder/library
embed. If an embed already exists for that media or folder set, it is returned
instead. A single-media embed is viewable by anyone with the link while the media’s
privacy mode is public (the default); a folder embed is created with an
auto-generated password. Use update_embed to change privacy or the password, or to
show labels and comments (meta isLabels, isComments; off by default), or to brand a
shared dashboard (meta logo, logoDark, theme, backgroundColor, primaryColor,
titleColor, fontFamily).
Parameters
create_embed takes 2 parameters, all of them optional.
| Name | Type | Required | Description |
|---|---|---|---|
mediaId |
string | No | Media file to embed (for a single-media embed) |
folderIds |
array of string | No | Folder IDs to embed (for a folder/library embed) |
Behaviour
The Speak AI MCP server publishes these behaviour hints for create_embed.
- 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
- Embed players lists the rest of the Embed players category.
- Tool reference lists every Speak AI MCP server tool.
- MCP server covers setup, supported clients, and what agents can do once connected.