DocsTeams and API

MCP server

Use VidSwarm from an AI assistant that supports the Model Context Protocol: Claude, ChatGPT, Claude Code, Cursor or Codex.

Status: Planned

Planned

This page describes a feature that is designed but not built yet. The changelog shows what is live today. Changelog

What it is

The Model Context Protocol (MCP) is an open standard that lets AI assistants call tools. VidSwarm’s MCP server (Streamable HTTP) lets you say “Make a 10-minute film on the history of the Silk Road for my history channel” in your assistant and follow the film there. The setup for each client is on /mcp.

Tools

  • list_channels: your channels with niche and language.
  • create_film: starts a film from an idea; planning is free and nothing is charged.
  • get_film: where a film stands: its plan with the price, approvals and script.
  • get_task and submit_result: your own agent writes the plan and script on your subscription.
  • list_films, film_notes, add_note, note_update: the review notes from the editor.
  • render and render_status: render a film or only its changed scenes, and follow it.
  • balance: credits left in the workspace.

Connecting

  • Claude (claude.ai and the Claude app): Settings › Connectors › Add custom connector, paste the server address, Connect, sign in with VidSwarm, pick the workspace and approve.
  • ChatGPT (developer mode): create a connector with the server address and Authentication: OAuth, then sign in with VidSwarm and approve.
  • Claude Code: claude mcp add --transport http vidswarm <server address>, then run /mcp and sign in.
  • Cursor and Codex: create an API key on /dashboard/developers/api-keys and send it as “Authorization: Bearer vs_…”; /mcp has the config for each.
  • Ask the assistant to list your channels to check the connection.

Only workspace owners can approve an app. On the approval page “Write films” and “Spend minutes” can be unticked; reading is always on. A connected app has the same tools, permissions and rate limit as an API key and stays signed in until you disconnect it under Developers › Connected apps.

Spending through an assistant

A film created through MCP stops at its storyboard; credits are reserved only when you approve it. Renders reserve their price when they start. An app approved without “Spend minutes” cannot spend at all.