MCP server
Use VidSwarm from an AI assistant that supports the Model Context Protocol. Part of the planned API.
Planned
What it is
The Model Context Protocol (MCP) is an open standard that lets AI assistants call tools. VidSwarm’s MCP server exposes the same actions as the REST API, so you can say “Start a 10-minute film on the history of the Panama Canal for my history channel” in an assistant and follow it there.
Tools
- list_channels: lists your channels with id, name and language.
- start_film: starts a film with channel, topic, format or reference URL, length and language, and returns the film id and the minutes it will reserve.
- film_status: returns the status, current step and progress of a film.
- get_package: returns the upload package of a finished film: links to the video, thumbnails, titles, description, chapters, Shorts and source log.
Connecting
- Create an API key on
/app/developers. - Copy the MCP server address and the configuration snippet shown on the same page.
- Add the server to your assistant’s MCP settings with the key.
- Ask the assistant to list your channels to check the connection.
Spending through an assistant
start_film starts a film that stops at its storyboard; nothing is reserved until you approve the storyboard in the studio. Most assistants ask before calling a tool; keep that confirmation on for start_film. Films started through MCP never publish to YouTube.
Status: planned
The MCP server is not open yet. Tool names and fields may change before it opens; the changelog announces when it does.