@ugccopilot/mcp

Official MCP (Model Context Protocol) server for UGC Copilot. Generate UGC-style video ads end-to-end from Claude Desktop, Cursor, Cline, Zed, or any MCP-compatible agent.

12 tools across free + authenticated tiers wrapping the public REST API. Render with Sora 2, Veo 3.1, Kling 3.0, or Seedance 2.0. Pay-as-you-go — no subscription required.

Quick start

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "ugc-copilot": {
      "command": "npx",
      "args": ["-y", "@ugccopilot/mcp@latest"],
      "env": {
        "UGC_COPILOT_API_KEY": "ugc_live_..."
      }
    }
  }
}

Restart Claude Desktop. Twelve tools will appear in the tools list.

Cursor

Add to .cursor/mcp.json in your project (or to user settings):

{
  "mcpServers": {
    "ugc-copilot": {
      "command": "npx",
      "args": ["-y", "@ugccopilot/mcp@latest"],
      "env": {
        "UGC_COPILOT_API_KEY": "ugc_live_..."
      }
    }
  }
}

Cline / Continue / Zed

Same pattern — point your MCP client at npx -y @ugccopilot/mcp@latest with the env var set.

Forcing a version refresh

Claude Desktop spawns the MCP server once per launch and npx caches resolved packages in ~/.npm/_npx/. After we publish a new version, your running session keeps using the old one until the process restarts and npx re-resolves.

If a Claude Desktop restart isn't picking up a newer version:

rm -rf ~/.npm/_npx
# Then quit Claude Desktop fully (⌘Q on macOS) and relaunch.

Pinning @latest in your config (as above) makes npx more aggressive about checking the registry on each cold start. If you'd rather lock to a specific version for stability, replace @latest with the exact version, e.g. @ugccopilot/[email protected].

Tools

Free tier (no API key required)

| Tool | Purpose | Limit | |---|---|---| | analyze_trends | Industry trend analysis with viral hook ideas | 3/day per IP | | generate_hooks | 10 scroll-stopping hooks for a product | 5/day per IP | | generate_persona_preview | Creator persona preview (name, pillars, voice) | 3/day per IP | | generate_script_preview | 3-hook, 3-scene preview script | 3/day per IP |

Authenticated tier (requires UGC_COPILOT_API_KEY)

| Tool | Purpose | Cost | |---|---|---| | analyze_market | Trending products + market analysis (composite) | 1 credit | | generate_script | Full viral script with platform variations | 1 credit | | generate_image | Scene image from a visual prompt | 1 std / 2 hq | | render_video | Start an async video render | 9-305 credits | | check_video_status | Single-shot poll | 0 | | wait_for_video | Poll with backoff up to ~50s | 0 | | fetch_video | Get the rendered MP4 URL | 0 | | apply_text_overlay | Burn captions/CTAs onto a video | 1/call |

Get an API key

Sign up at https://ugccopilot.ai/signup and generate a key from Profile → API Keys. The key has the ugc_live_ prefix.

You only need a key for the authenticated tier — the four free tools work without one.

Credit pricing

PAYG packs (no subscription required): 200 credits / $25, 500 / $50, 2,500 / $200, 10,000 / $700. Subscriptions include monthly bundled credits and higher concurrency caps. See https://ugccopilot.ai/pricing.

Video render costs vary by engine, quality, and duration:

• Sora 2: 18 std / 65 hq (8s baseline, scales by duration)
• Veo 3.1: 40 std / 130 hq (fixed cost)
• Kling 3.0: 32 std / 50 hq / 130 4k (6.4s baseline) — 4K is native, no upscaling
• Seedance 2.0: 18 std / 35 hq (4s baseline)

Long-running video renders

render_video returns an operationName immediately. To get the final MP4:

1. Call wait_for_video — polls up to ~50s (stays inside the MCP tool window).
2. If still pending, the agent gets back the operationName and a hint to call check_video_status again in 30s.
3. When done, call fetch_video to get the signed MP4 URL.

Errors

Errors include actionable hints:

• 402 insufficient-credits → buy a credit pack at https://ugccopilot.ai/pricing/#packs
• 429 rate-limited (free tier) → set UGC_COPILOT_API_KEY for the higher-volume authenticated tier
• 400 validation → details field describes which input was rejected
• 5xx / network → automatic retry with backoff, then surface

Source & support

• Source: https://github.com/Zduane/ugc-copilot-mcp
• Server manifest: https://ugccopilot.ai/.well-known/mcp.json
• API documentation: https://ugccopilot.ai/api/
• OpenAPI 3.1 spec: https://ugccopilot.ai/.well-known/openapi.json
• Support: [email protected]

License

MIT