Clip Studio MCP

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):

   {
     "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.

Tool	Description
list_video_lab_models	List models, modes, and defaults. Same catalog as /video-lab.
quote_video_lab	Quote a setup. Does not generate. Paid generate needs this quote.
generate_video_lab	Start a paid generation. Poll get_video_lab_generation.
list_video_lab_generations	List this account’s Video Lab generations.
get_video_lab_generation	Fetch one generation by video id.
reconcile_video_lab_generation	Refresh a job from the provider. Does not debit again.
presign_generation_asset	Create an upload slot for a source image or MP4. Then complete_generation_asset.
complete_generation_asset	Mark a source image or MP4 upload ready.

Topic Shorts

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

Tool	Description
list_hook_bank	Opening hooks templates (Problem, Curiosity, Trust, Niche). Seeds topic/brief; not caption style.
create_topic_short_story	Preview beats, narration, and English stock queries. Does not render.
quote_topic_short	Quote a Topic Short. Does not render. Quoted on duration.
generate_topic_short	Generate from a topic or reviewed storyPlan. Poll get_topic_short.
get_topic_short	Fetch a generation.

Talking Shorts

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

Tool	Description
research_talking_short	Research from a URL or brief. Does not render.
quote_talking_short	Quote a Talking Short. Does not render.
generate_talking_short	Start a paid Talking Short. Poll get_talking_short.
get_talking_short	Fetch a generation.
list_talking_short_actors	List catalog stills. Does not render.

Ad Studio

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

Tool	Description
research_ad_studio	Research angles and a locked 5-beat script. Does not render.
quote_ad_studio	Quote an Ad Studio job. Catalog creators only.
generate_ad_studio	Start a paid clip. Poll get_ad_studio.
get_ad_studio	Fetch a generation. Submit and poll.

Last Frame

Play a generated film. The last frame is canon.

Tool	Description
list_last_frame_games	List games (Adventure, Heist, Tape, and the rest).
list_last_frame_worlds	List catalog worlds/maps.
quote_last_frame	Quote an opening or next shot. Does not film.
start_last_frame	Start a run and film the opening shot.
get_last_frame_run	Get a run, including the latest shot and choices.
choose_last_frame	Pick a numbered option. Films the next shot.
type_last_frame	Type a custom move. Films the next shot.
timeout_last_frame	Apply the choice timeout (HUD timer).
end_last_frame_clip	Tell the run the current shot finished playing.
arm_last_frame_item	Arm an inventory item for the next move (itemIndex is 0-based).
create_last_frame_world	Create a custom world from a description.

Image Lab

Quoted stills. Same catalog as /image-lab.

Tool	Description
list_image_lab_models	List models, modes, and aspect ratios.
quote_image_lab	Quote a still. Does not generate. Paid generate needs this quote.
generate_image_lab	Start a paid still. Poll get_image_lab_generation.
list_image_lab_generations	List this account’s Image Lab generations.
get_image_lab_generation	Fetch one generation and refresh it from the provider.

Audio Lab

Script → downloadable narration with Clip Studio voices.

Tool	Description
list_audio_lab_voices	List narration voices (accent and locale).
quote_audio_lab	Quote a script. Does not generate.
generate_audio_lab	Start paid narration. Poll get_audio_lab_generation.
list_audio_lab_generations	List this account’s Audio Lab generations.
get_audio_lab_generation	Fetch one generation and refresh it from the provider.

Story

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

Tool	Description
list_storyboard_themes	List visual themes (carries across parts).
list_storyboard_voices	List narration voices (carries across parts).
estimate_storyboard	Estimate the next part from a script. Does not render.
create_storyboard	Start a project from a full story. Does not write a part or film.
get_storyboard	Fetch a project, or omit projectId to list recent ones.
generate_storyboard_part	Write the next part on an existing project. Does not film.
render_storyboard	Film the latest part. Poll get_storyboard.

Ad Lab

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

Tool	Description
import_ad_website	Read a public website into a company profile.
quote_ad	Quote a static layout. Does not generate.
generate_ad	Generate stills (layout 9:16, 1:1, 4:5, or 16:9). Poll get_ad_generation.
quote_ad_tip_pack	Quote a tip pack. Does not generate.
generate_ad_tip_pack	Generate a tip pack. Poll get_ad_generation.
quote_ad_proof_pack	Quote a Proof pack. Does not generate.
generate_ad_proof_pack	Generate a Proof pack. Poll get_ad_generation.
quote_ad_explain	Quote an Explain film. Does not generate.
generate_ad_explain	Generate an Explain film from a product photo and brief.
list_ad_generations	List jobs. Optional companyId or kind tip_pack, proof_pack, explain.
get_ad_generation	Fetch one job.

Library

Clips you already generated. Publish is a public Clip Studio page, not social auto-post.

Tool	Description
list_library	List clips in the library.
get_clip	Fetch one library clip.
publish_generation	Publish a completed generation to a public page.
unpublish_generation	Unpublish a generation you made public.
get_generation_publication	Whether a generation is public, and its public URL if it is.
list_public_generations	List public publications. Optional kind, model, limit.
get_public_generation	Fetch one public publication by clip id.

Free tools

Copy, hooks, briefs, and planning tools at /tools. Does not generate video.

Tool	Description
list_free_tools	List public free tools.
run_free_tool	Run a free tool (slug + input).

Account

Plan, usage, and billing helpers.

Tool	Description
list_public_products	List public products an agent can use through this server.
get_account	Plan and usage for the signed-in account, including offerCheckout price IDs after a 402.
create_checkout_url	Create a Stripe Checkout URL for a priceId. Does not take card data.

Links

• Product: https://clipstudio.ai/mcp
• Pricing: https://clipstudio.ai/pricing
• Support: https://clipstudio.ai/support
• Email: support@clipstudio.ai
• Smithery: https://smithery.ai/servers/clipstudioai/clipstudio
• Registry entry: server.json (ai.clipstudio/mcp) — see PUBLISHING.md

Keeping this in sync

The tool list mirrors https://clipstudio.ai/mcp.md. When that page changes, update the tables here by hand. See scripts/sync-tools.md. This repo does not import Clip Studio’s private source.