Vai al contenuto

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.

Easiest: let your AI set it upCopy one prompt into Claude Code, Codex or Cursor. It installs Yoh and walks you through sign-in, on macOS, Linux or Windows.

Connect any MCP client

  1. 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/mcp
  2. Claude 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 Code
    claude mcp add --transport http --scope user yoh https://www.yoh.app/api/mcp
    claude mcp login yoh
    Codex
    codex 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"
        }
      }
    }
  3. 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
        }
      }
    }
  4. 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