{
  "markdown": "# UnrealUGC MCP Server\n\n[![npm](https://img.shields.io/npm/v/@unrealugc/mcp)](https://www.npmjs.com/package/@unrealugc/mcp)\n[![CI](https://github.com/UnrealUGC/mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/UnrealUGC/mcp/actions/workflows/ci.yml)\n\nThe official [Model Context Protocol](https://modelcontextprotocol.io) server for\n[UnrealUGC](https://unrealugc.com). It gives MCP-compatible assistants eleven typed tools for\nbrowsing creators and models, estimating credit cost, and generating AI UGC video ads.\n\nThis repository contains only the public MCP adapter. The UnrealUGC application and backend\nremain private.\n\n## Prerequisites\n\n- Node.js 20 or newer\n- An UnrealUGC API key from **Dashboard → Settings → API Keys**\n\nAPI keys start with `usk_live_` and should be stored in your MCP client's environment settings,\nnever committed to a repository.\n\n## Local stdio setup\n\nYou do not need to install the package globally. MCP clients can launch it with `npx`.\n\n### Claude Desktop\n\nAdd this server to your Claude Desktop configuration:\n\n```json\n{\n  \"mcpServers\": {\n    \"unrealugc\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@unrealugc/mcp\"],\n      \"env\": {\n        \"UNREALUGC_API_KEY\": \"usk_live_...\"\n      }\n    }\n  }\n}\n```\n\n### Claude Code\n\n```bash\nclaude mcp add unrealugc --env UNREALUGC_API_KEY=usk_live_... -- npx -y @unrealugc/mcp\n```\n\n### Codex\n\n```toml\n[mcp_servers.unrealugc]\ncommand = \"npx\"\nargs = [\"-y\", \"@unrealugc/mcp\"]\n\n[mcp_servers.unrealugc.env]\nUNREALUGC_API_KEY = \"usk_live_...\"\n```\n\nCursor, Windsurf, OpenClaw, and other stdio MCP clients use the same command and environment\nvariable.\n\n## Hosted Streamable HTTP setup\n\nClients that support remote MCP can connect without running a local process:\n\n```text\nURL: https://unrealugc.com/api/mcp\nAuthorization: Bearer usk_live_...\n```\n\nSee the [MCP setup guide](https://unrealugc.com/docs/mcp) for client-specific instructions.\n\n## Tools\n\n| Tool | Purpose |\n| --- | --- |\n| `get_me` | Confirm the account, plan, and balance behind an API key |\n| `get_credits` | Read subscription and purchased credit pools |\n| `list_models` | Browse available video models and capabilities |\n| `list_creators` | Browse stock creators and custom avatars |\n| `list_voices` | Browse stock and custom voices |\n| `list_projects` | Find product and campaign projects |\n| `create_project` | Create a project for related generations |\n| `list_videos` | Browse generation history with filters and pagination |\n| `get_video` | Poll a generation and retrieve its output URL |\n| `estimate_video_cost` | Estimate credits from the script before spending |\n| `generate_video` | Start an asynchronous video generation |\n\n`generate_video` supports native or selected voices, silent reaction/b-roll clips, per-scene\nvisual directions, and parallel or sequential multi-clip generation.\n\n## Generation flow\n\n1. Call `list_models` and `list_creators`.\n2. Call `estimate_video_cost` with the proposed script.\n3. Check `get_credits` if budget matters.\n4. Call `generate_video`.\n5. Poll `get_video` about every 15 seconds, or use UnrealUGC webhooks for completion events.\n\n## Environment variables\n\n| Variable | Required | Default |\n| --- | --- | --- |\n| `UNREALUGC_API_KEY` | Yes | — |\n| `UNREALUGC_BASE_URL` | No | `https://unrealugc.com` |\n| `UNREALUGC_REQUEST_TIMEOUT_MS` | No | `30000` |\n\n`UNREALUGC_BASE_URL` is intended for UnrealUGC development and staging environments.\n\n## Development\n\n```bash\nnpm ci\nnpm run check\nnpm pack --dry-run\n```\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) before opening a pull request. Security reports should\nfollow [SECURITY.md](SECURITY.md).\n\n## Links\n\n- [UnrealUGC MCP overview](https://unrealugc.com/mcp)\n- [MCP documentation](https://unrealugc.com/docs/mcp)\n- [REST API documentation](https://unrealugc.com/docs/api)\n- [UnrealUGC dashboard](https://unrealugc.com/dashboard)\n\n## License\n\nMIT © Next MVP Solutions LLC\n",
  "bytes": 3903,
  "sha": "fefc3fb29634a07b17067ec0760a04a20ae597471e7b5ac30a8996204bbd2531",
  "repo_slug": "unrealugc/mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_com_unrealugc_mcp_2ab72e61/readme"
}