Use the Speak AI MCP server tool get_clips to list clips, optionally filtered by
folder or media files.
What does it do?
List clips, optionally filtered by folder or media files. If clipId is provided, returns a single clip with its download URL (when processed).
Parameters
get_clips takes 3 parameters, all of them optional.
| Name | Type | Required | Description |
|---|---|---|---|
clipId |
string | No | Get a specific clip by ID |
folderId |
string | No | Filter clips by folder ID |
mediaIds |
array of string | No | Filter clips by source media file IDs |
Behaviour
The Speak AI MCP server publishes these behaviour hints for get_clips.
- Only reads data. Does not modify your workspace.
- Does not delete or overwrite existing data.
- Repeating an identical call is safe.
- Stays inside Speak AI. Does not reach other systems.
Related
- Clips lists the rest of the Clips category.
- Tool reference lists every Speak AI MCP server tool.
- MCP server covers setup, supported clients, and what agents can do once connected.