MCP Server

The MCP server exposes every public API endpoint as a typed tool. Two transports — pick the one your client supports.

• Stdio via npx -y @unrealugc/mcp — works in Claude Cowork, Claude Code, OpenClaw, Hermes Agent, and any local MCP host.
• Hosted HTTP at https://unrealugc.com/api/mcp — works in Claude.ai and any client that supports remote MCP.

Auth: your UnrealUGC API key. Same key for both transports.

No global install. Your client runs npx -y @unrealugc/mcp on demand and tears it down on quit.

Claude Cowork

Open Claude Cowork settings → Tools & MCP servers → Add server. Use the same JSON shape below — Cowork picks it up automatically and the new generate_video tool is available to every agent on your machine.

{
  "mcpServers": {
    "unrealugc": {
      "command": "npx",
      "args": ["-y", "@unrealugc/mcp"],
      "env": {
        "UNREALUGC_API_KEY": "usk_live_..."
      }
    }
  }
}

Claude Code

claude mcp add unrealugc \
  --env UNREALUGC_API_KEY=usk_live_... \
  -- npx -y @unrealugc/mcp

OpenAI Codex

Add to ~/.codex/config.toml:

[mcp_servers.unrealugc]
command = "npx"
args = ["-y", "@unrealugc/mcp"]
env = { UNREALUGC_API_KEY = "usk_live_..." }

For clients that support remote MCP (Claude.ai custom connectors, newer IDEs), skip stdio and register:

https://unrealugc.com/api/mcp

Auth via the same API key as a Bearer token. The endpoint implements JSON-RPC over POST per the Streamable HTTP transport spec.

• OpenClaw — add UnrealUGC under tools/mcp.json in your OpenClaw config.
• Hermes Agent — register UnrealUGC in your Hermes workspace.toml under[mcp.servers].
• All other agents — anything MCP-compatible works. See the generic agents page.

• get_me — account info and credit balance
• get_credits — credit balance breakdown
• list_models — available video models
• list_creators — stock + custom creators
• list_voices — stock + custom voices
• list_projects / create_project
• list_videos / get_video
• estimate_video_cost — credit estimate before generating
• generate_video — start a new generation

Full JSON Schema input definitions are auto-discovered via tools/list.

Use one project for a product or campaign, including different creators, scripts and ad variants. First call list_projects and reuse the matching project. Follow next_cursor when has_more is true.

If you need a new campaign, call create_project once before generating the batch. Pass its returned ID as projectId on every generate_video call. Omitting it creates a separate project each time, even when the product name is the same.

Once connected, you can ask your agent things like:

• “Show me all 30-something female creators with an American accent, generate a 10-second ad with the highest-rated one.”
• “How many credits do I have, and how many 15-second Kling videos can I make this month?”
• “Generate three ad-copy variations across three creators, then check on them in 5 minutes and tell me which performed best.”

• UNREALUGC_API_KEY — required.
• UNREALUGC_BASE_URL — optional, defaults to https://unrealugc.com.