The Yoh MCP server for AI video
One remote MCP endpoint gives any agent the whole Yoh studio: write a story, cast and draw characters, generate clip videos with voices and music, edit the timeline and captions, render and publish. Every tool follows the same rules as the yoh.app editor.
Connect any MCP client
Use this address
Streamable HTTP, sign-in with OAuth. Use the www address exactly: yoh.app without www redirects, and sign-in checks the address.
https://www.yoh.app/api/mcpClaude Code, Codex, Cursor, ChatGPT
Each login command opens your browser to sign in to Yoh. For Cursor, merge the yoh entry into ~/.cursor/mcp.json and sign in when Cursor asks. ChatGPT: add a custom MCP server and sign in. Claude desktop and claude.ai: add a custom connector.
Claude Codeclaude mcp add --transport http --scope user yoh https://www.yoh.app/api/mcp claude mcp login yohCodexcodex mcp add yoh --url https://www.yoh.app/api/mcp codex mcp login yoh~/.cursor/mcp.json{ "mcpServers": { "yoh": { "url": "https://www.yoh.app/api/mcp" } } }Or use an API key
For clients that cannot sign in, scripts and CI: create a key at Settings → API keys with the scopes you need and send it as a Bearer token.
.mcp.json{ "mcpServers": { "yoh": { "type": "http", "url": "https://www.yoh.app/api/mcp", "headers": { "Authorization": "Bearer ${YOH_API_KEY}" }, "timeout": 900000 } } }Check the connection
Ask your agent to run get_credits. It should answer with your Yoh credit balance. Run /mcp in Claude Code or Codex to see the server's status.
Then just ask
- “Make a 60-second story about a night-shift nurse who can hear ghosts.”
- “Turn this script into a five-episode series and show me the cast before you draw anything.”
- “Tighten episode 3: trim the dead air, move the captions onto the beats, then quote the render.”
- “Swap the lead in clip 4 for my character and redo only that clip's video.”
Why it works well
What the tools cover
Stories and series, scripts and PDFs split into episodes, characters, sets and items, clip pictures and videos, voices and lip sync, music and sound, the timeline (moves, trims, splits, captions, overlays), renders, publishing, templates and hiring creators.
Nothing is charged without your OK
Reading and editing are free. Every step that spends credits (drawing pictures, generating clip videos, rendering) first returns a price. The agent shows it to you and only goes ahead after you approve, and the same approval cannot be charged twice.
Scoped access
Keys and sign-ins carry scopes (stories:read, stories:write, stories:generate, series, assets, hires, ads), so a read-only agent can never spend or change anything.
Long jobs you can resume
Generation and renders run as durable jobs: start once, poll get_job or get_run, stop with cancel_generation. Sending the same approval again joins the same run instead of charging twice.
Questions
What is the Yoh MCP server address?
https://www.yoh.app/api/mcp (streamable HTTP). Sign in with your Yoh account, or send an API key as a Bearer token.
Which clients work?
Any MCP client that supports remote HTTP servers: Claude Code, the Claude desktop app, claude.ai, Codex, ChatGPT, Cursor, VS Code with GitHub Copilot and others.
Is the MCP server free?
Connecting, reading and editing are free. Generation and rendering use your Yoh credits, and each paid step needs your explicit approval of its quoted price.
Is there a REST API too?
Yes. The same account works with the REST API at /api/v1 using API keys; see the API page and the docs.
Full reference: Yoh docs · Pricing
Other ways to connect
- Make AI videos with ClaudeConnect Claude to your Yoh account and make video stories by asking. Claude writes the script, keeps characters consistent, generates the clips, edits the timeline and renders the finished video, and checks with you before anything costs credits.
- Make AI videos with CodexConnect Codex to Yoh and let it produce video stories from your terminal or editor: script, cast, clips, voices, captions and the final render, with a price shown and approved before every paid step.
- AI video generation APISend a prompt, get back a finished video: Yoh writes the script, casts consistent characters, adds voices, music and captions and renders the MP4. Or drive each step yourself: stories, series, clips, characters, timeline and renders.
- The Yoh skill for AI agentsThe MCP server gives your agent the tools; the skill teaches it the craft. A SKILL.md in the open Agent Skills format tells the agent how to make a Yoh story well and the rules that are easy to get wrong.