ClipUGC MCP server

ClipUGC CLI

Official command-line interface for ClipUGC — create AI influencers, generate photorealistic looks of the same person, turn them into silent-reaction clips, and merge your app's screen recording into a ready-to-post UGC ad. All from the terminal; nothing renders locally.

npm install -g clipugc
clipugc auth login

Requires Node.js >= 20. Create an API key in the ClipUGC dashboard (API keys section). API keys are available on paid plans (Professional and Business).

Use it with Claude Code

The fastest way in: this repo ships three Claude Code skills, so you describe what you want instead of learning flags. clipugc drives the CLI conversationally, ugc-director turns an app idea into a complete ad plan, and persona-account runs an ongoing AI creator account.

/plugin marketplace add clipugc/ClipUGC-CLI
/plugin install clipugc@ClipUGC-CLI

Installed as a plugin, the skills are namespaced under it:

/clipugc:ugc-director make a TikTok ad for my habit tracker app
/clipugc:persona-account create an AI influencer for a fitness account
/clipugc:clipugc how many credits do I have left

(Cloning the repo instead? Claude Code reads .claude/skills/ directly and the skills are unprefixed — /ugc-director, /persona-account, /clipugc.)

See docs/skills.md for what each skill knows.

Prefer flags? Everything below works standalone — the skills just drive the same CLI.

Use from Claude Code / Cursor

Listed on the MCP Registry and Smithery.

The CLI is also an MCP server. clipugc mcp speaks the Model Context Protocol over stdio, so any MCP client can create characters, looks, clips and merged ads as tools, without shelling out to the commands above.

Log in once so the server has a key (it reads the same ~/.config/clipugc/config.json the CLI uses):

npm install -g clipugc
clipugc auth login

Claude Code

claude mcp add clipugc -- npx -y clipugc@latest mcp

@latest matters: without it npx reuses any clipugc already installed on your machine, and a global install older than 1.2.0 has no mcp command, so Claude Code reports "Connection closed". If you still see that, update the old install with npm i -g clipugc@latest, or run npx -y clipugc@latest mcp once in a terminal so the download finishes (Ctrl+C after "11 tools ready"). Do not add it from inside a checkout of this repo: there npx resolves clipugc to the local project instead of the npm package.

Cursor (Settings > MCP, or .cursor/mcp.json in your project)

{
  "mcpServers": {
    "clipugc": {
      "command": "npx",
      "args": ["-y", "clipugc@latest", "mcp"]
    }
  }
}

If you would rather not run clipugc auth login on that machine, add an env block with CLIPUGCAPIKEY set to a key from the dashboard.

Claude Desktop

Claude Desktop installs the server as an extension, so there is no config file to edit and no Node install needed beyond the app itself:

from the latest GitHub release.

1. Download clipugc.mcpb

and choose Install Extension (Advanced settings on some versions).

1. Double-click the file, or open Claude Desktop, go to Settings > Extensions,

dashboard under API Keys.

1. Paste your ClipUGC API key when asked. Create one in the

The extension runs the same clipugc mcp server as above. To build the bundle yourself, run npm run build:mcpb (see "Local development").

Shortened. The full README is on GitHub.