MCP Server

Connect agents to Videotok over Streamable HTTP.

Videotok exposes a remote MCP server over Streamable HTTP.

Endpoint:

https://www.videotok.app/api/mcp

Auth:

Videotok sign-in through the MCP connector OAuth flow, then approve workspace access.

Available Tools

Tool	What it does
`get_workspace`	Returns the organization and scopes attached to the current connection.
`list_generation_catalog`	Lists templates, models, variants, presets, quality tiers, and estimated credits. Pass section and template_slug to inspect one template and its presets.
`list_workspace_assets`	Lists brand kits, avatars, media, and reference template targets.
`create_generation`	Creates static ads, video ads, UGC ads, and AI model outputs.
`get_generation`	Checks generation status.
`create_slideshow`	Creates slideshow and carousel workflows.
`get_slideshow`	Checks slideshow status.
`create_faceless_video`	Creates faceless video workflows.
`get_video`	Checks video status.
`suggest_reference_template_targets`	Suggests where uploaded reference media should be stored.
`create_reference_inspiration`	Saves user reference media to a selected template.
`list_reference_inspirations`	Lists saved references.
`recommend_reference_inspirations`	Recommends saved references.
`create_editor_video`	Creates an editable video draft.
`list_editor_videos`	Lists editable videos.
`get_editor_video`	Gets editor video state summary.
`list_editor_media`	Lists workspace media for editing.
`upload_editor_media`	Uploads media from chat and optionally adds it to a video.
`add_editor_media`	Adds existing media or a direct URL to a video.
`apply_editor_edits`	Applies supported editor operations.
`list_social_accounts`	Lists connected Instagram, TikTok, X, LinkedIn, Threads, YouTube, and Pinterest accounts.
`publish_media_to_social`	Queues publishing for completed My Media images, GIFs, and videos.

Agent Flow

Call get_workspace, list_generation_catalog, and list_workspace_assets.
Ask the user for missing choices such as template, brand kit, avatar, or saved reference.
For template workflows, call list_generation_catalog again with section and template_slug, then choose a built-in preset_id or saved custom_reference_inspiration_id.
Call the matching create tool with a short user prompt. Built-in preset/reference prompts are internal and must not be exposed.
Poll the status tool until the asset is ready.

Scopes And Errors

The MCP server uses Videotok sign-in and short-lived OAuth bearer tokens issued after workspace approval.

Read tools require generations:read or generations:write.

Create, upload, and edit tools require generations:write.

Social account reads require social:read or social:write.

Social publishing requires social:write. Duplicate social account ids are ignored before publishing.

Tool errors use the same structured API error shape when they cross the HTTP boundary.

For paid tools, pass idempotency_key and retry only when the error is retryable.

PreviousVideo Editor

NextErrors And OpenAPI

Available Tools

Tool	What it does
`get_workspace`	Returns the organization and scopes attached to the current connection.
`list_generation_catalog`	Lists templates, models, variants, presets, quality tiers, and estimated credits. Pass section and template_slug to inspect one template and its presets.
`list_workspace_assets`	Lists brand kits, avatars, media, and reference template targets.
`create_generation`	Creates static ads, video ads, UGC ads, and AI model outputs.
`get_generation`	Checks generation status.
`create_slideshow`	Creates slideshow and carousel workflows.
`get_slideshow`	Checks slideshow status.
`create_faceless_video`	Creates faceless video workflows.
`get_video`	Checks video status.
`suggest_reference_template_targets`	Suggests where uploaded reference media should be stored.
`create_reference_inspiration`	Saves user reference media to a selected template.
`list_reference_inspirations`	Lists saved references.
`recommend_reference_inspirations`	Recommends saved references.
`create_editor_video`	Creates an editable video draft.
`list_editor_videos`	Lists editable videos.
`get_editor_video`	Gets editor video state summary.
`list_editor_media`	Lists workspace media for editing.
`upload_editor_media`	Uploads media from chat and optionally adds it to a video.
`add_editor_media`	Adds existing media or a direct URL to a video.
`apply_editor_edits`	Applies supported editor operations.
`list_social_accounts`	Lists connected Instagram, TikTok, X, LinkedIn, Threads, YouTube, and Pinterest accounts.
`publish_media_to_social`	Queues publishing for completed My Media images, GIFs, and videos.

Agent Flow

Call get_workspace, list_generation_catalog, and list_workspace_assets.

Ask the user for missing choices such as template, brand kit, avatar, or saved reference.

For template workflows, call list_generation_catalog again with section and template_slug, then choose a built-in preset_id or saved custom_reference_inspiration_id.

Call the matching create tool with a short user prompt. Built-in preset/reference prompts are internal and must not be exposed.

Poll the status tool until the asset is ready.