Clip Studio MCP

Hosted Model Context Protocol server for Clip Studio. Add one URL to Claude, Cursor, ChatGPT, or any MCP client and use the same public Clip Studio products a signed-in human already has — Video Lab, Topic Shorts, Talking Shorts, Ad Studio, Last Frame, Image Lab, Audio Lab, Story, Ad Lab, library, and free tools — on the same plan as the website.

Endpoint: https://clipstudio.ai/api/mcp
Transport: Streamable HTTP
Marketing: https://clipstudio.ai/mcp
Public tool list: https://clipstudio.ai/mcp.md
Repository: https://github.com/j-acks0n/clipstudio-mcp
Smithery: https://smithery.ai/servers/clipstudioai/clipstudio

This repo is a connector listing (server.json, install snippets, examples). The server is hosted. There is nothing to clone and run.

Quick start

Paste the URL. Leave OAuth client id empty. Sign in when the client opens Clip Studio, then Approve.

Claude Desktop / Claude.ai connectors

Customize → Connectors → Add custom connector. Paste:

https://clipstudio.ai/api/mcp

Connect. Leave OAuth client id empty.

Cursor

Add an HTTP MCP server in ~/.cursor/mcp.json. Cursor runs OAuth on first use.

{
  "mcpServers": {
    "clipstudio": {
      "url": "https://clipstudio.ai/api/mcp"
    }
  }
}

ChatGPT (developer mode connector)

Enable developer mode, add a custom MCP connector, paste https://clipstudio.ai/api/mcp, then complete Clip Studio Approve.

Windsurf

Edit ~/.codeium/windsurf/mcp_config.json (remote field is serverUrl):

{
  "mcpServers": {
    "clipstudio": {
      "serverUrl": "https://clipstudio.ai/api/mcp"
    }
  }
}

Save, then refresh MCP in Cascade.

VS Code / Copilot

User or workspace mcp.json:

{
  "servers": {
    "clipstudio": {
      "type": "http",
      "url": "https://clipstudio.ai/api/mcp"
    }
  }
}

Command Palette → MCP: Open User Configuration, or .vscode/mcp.json in a workspace.

Stdio-only clients

Bridge to Streamable HTTP:

npx -y mcp-remote https://clipstudio.ai/api/mcp

Example wrapper:

{
  "mcpServers": {
    "clipstudio": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://clipstudio.ai/api/mcp"]
    }
  }
}

Authentication

One-click OAuth on the first call. Unauthenticated requests — including initialize and tools/list — return HTTP 401 with WWW-Authenticate and protected-resource metadata. The client dynamically registers (OAuth 2.1 + PKCE, public client). You sign in with the Clip Studio account and Approve. Tokens stay on the client.

No client id to paste. If a human cannot do the job on clipstudio.ai, the agent cannot do it here.

How a paid job works

1. Quote (quote_*). Does not generate.

2. If the monthly generation allowance cannot cover the quote, the tool returns HTTP 402 with numeric JSON fields (names only — these are API keys, not UI copy):

   config.json

   Copy

   {
     "requiredCredits": 120,
     "availableCredits": 0
   }
   

   Then call create_checkout_url with a priceId from get_account.offerCheckout. It returns a Stripe Checkout URL and does not take card data.

3. Generate (generate_* / start_last_frame / render_storyboard / …). Uses this month’s generation allowance.

4. Poll the matching get_* tool until the job finishes.

Submit and poll. Do not hold the MCP request for a full provider render.

Example prompts

• Preview a 15-second Topic Short about why most morning routines fail, then quote and generate it.
• List Video Lab models, quote an 8-second 16:9 clip of a running shoe on a wet track, generate, and poll until it is ready.
• Continue my story: load the latest project, write the next part, then render it.
• Check my remaining monthly generation allowance. If a quote returns 402, open checkout from offerCheckout.
• Research an Ad Studio clip from this product URL, pick a catalog creator, quote, generate, and poll.

Walkthroughs: examples/.

Tools

Names match https://clipstudio.ai/mcp.md. Paid tools use this month’s generation allowance.

Video Lab

Frontier text- and image-to-video. Quote before generate.

Topic Shorts

Topic → story + stock + voice. Caption mode default current. Transition mode default dynamic.

Talking Shorts

Product URL or brief → talking-head clip. Catalog faces and voices.

Ad Studio

Product → angle → 5-beat script → catalog creator → one vertical clip.

Last Frame

Play a generated film. The last frame is canon.

Image Lab

Quoted stills. Same catalog as /image-lab.

Audio Lab

Script → downloadable narration with Clip Studio voices.

Story

Full story → parts → film. Continue my story on the same projectId.

Ad Lab

Website → static layouts, tip pack, Proof pack, or Explain film.