{
  "name": "ugc-copilot",
  "version": "0.1.0",
  "description": "Generate UGC-style video ads end-to-end (script, persona, image, video, overlay) from any MCP-compatible agent. Wraps the UGC Copilot REST API. Supports Sora 2, Veo 3.1, Kling 3.0, and Seedance 2.0.",
  "publisher": {
    "name": "UGC Copilot",
    "url": "https://ugccopilot.ai",
    "support": "support@ugccopilot.ai"
  },
  "documentation": "https://ugccopilot.ai/mcp/",
  "openapi": "https://ugccopilot.ai/.well-known/openapi.json",
  "transports": ["stdio"],
  "install": {
    "npm": "@ugccopilot/mcp",
    "command": "npx",
    "args": ["-y", "@ugccopilot/mcp@latest"]
  },
  "env": [
    {
      "name": "UGC_COPILOT_API_KEY",
      "description": "Bearer key from https://ugccopilot.ai/profile/#api-keys (prefix ugc_live_). Free tools work without it; authenticated tools require it.",
      "required": false
    }
  ],
  "tools": [
    {
      "name": "analyze_trends",
      "description": "Industry-level trend analysis. Returns 3-5 trending product opportunities with viral hooks, target audience, and price ranges. Free tier (3/day per IP).",
      "auth": "none"
    },
    {
      "name": "generate_hooks",
      "description": "Generate 10 scroll-stopping hook variations across the viral hook taxonomy for a product on TikTok, Instagram Reels, or YouTube Shorts. Free tier (5/day per IP).",
      "auth": "none"
    },
    {
      "name": "generate_persona_preview",
      "description": "Generate a creator persona preview (name, tagline, content pillars, hook styles, brand voice) for a niche and platform. Free tier (3/day per IP).",
      "auth": "none"
    },
    {
      "name": "generate_script_preview",
      "description": "Preview-tier viral UGC script with 3 hooks, 3 scenes, and a CTA from a product description and industry. Free tier (3/day per IP).",
      "auth": "none"
    },
    {
      "name": "analyze_market",
      "description": "Full market analysis: trending products + market trends, audience personas, top keywords, viral hooks, and strategy recommendations for an industry. Cost: 1 credit.",
      "auth": "api-key",
      "credits": 1
    },
    {
      "name": "generate_script",
      "description": "Full viral script with hook variations, scene-level visual prompts and dialogue, CTAs, and platform variations. Cost: 1 credit.",
      "auth": "api-key",
      "credits": 1
    },
    {
      "name": "generate_image",
      "description": "Generate a scene image for a script's visual prompt. Returns a permanent Firebase Storage HTTPS URL (JSON object: { imageUrl }). Cost: 1 credit (standard) / 2 credits (HQ).",
      "auth": "api-key",
      "credits": "1-2"
    },
    {
      "name": "render_video",
      "description": "Start an asynchronous video render via Sora 2, Veo 3.1, Kling 3.0, or Seedance 2.0. Returns an operationName. Cost: 18-130 credits depending on engine, quality, and duration.",
      "auth": "api-key",
      "credits": "18-130"
    },
    {
      "name": "check_video_status",
      "description": "Single-shot poll of an in-progress video render. Returns done=false (with progress 0-100) or done=true with the rendered video URI. No credits.",
      "auth": "api-key",
      "credits": 0
    },
    {
      "name": "wait_for_video",
      "description": "Poll a video render with exponential backoff up to ~50 seconds. Returns done with videoUri, or pending with operationName for the agent to keep checking. No credits.",
      "auth": "api-key",
      "credits": 0
    },
    {
      "name": "fetch_video",
      "description": "Get the signed MP4 URL for a completed video render (typical 7-day expiry). No credits.",
      "auth": "api-key",
      "credits": 0
    },
    {
      "name": "apply_text_overlay",
      "description": "Burn text overlays (captions, hooks, CTAs) onto a rendered video. Cost: 1 credit per call (multiple overlays in one call supported).",
      "auth": "api-key",
      "credits": 1
    }
  ],
  "registries": {
    "smithery": "https://smithery.ai/server/@ugccopilot/mcp",
    "github": "https://github.com/Zduane/ugc-copilot-mcp"
  }
}