NewGPT Image 2, Seedance 2.0, and Seedance 2.0 Fast are live on EzUGC!
Try Now
@ezugc/mcp Β· Model Context Protocol
EzUGC logoMCP

Bring EzUGC into any AI agent

Generate brand videos and image ads with any model β€” straight from Claude Code, Cursor, Claude Desktop, or any MCP client. One key, every EzUGC tool, no leaving your agent.

Claude CodeCursorClaude DesktopClineAny MCP client

Connect in three steps

A couple of minutes from install to your first generation

npx -y @ezugc/mcp
Generate your API key
01

Install EzUGC MCP

Run it straight from npm. Node.js 18+, nothing to clone.

npx -y @ezugc/mcp
02

Add it to your client

Drop this into your MCP config. Same command everywhere.

claude mcp add ezugc --env EZUGC_API_KEY=<key> -- npx -y @ezugc/mcp
03

Get your key

Create an ezk_live_ key from your dashboard. Paid plans only.

Generate your API key

Opens app.ezugc.ai Β· paid plans only

29 tools your agent can call

Ask in plain language. Your agent maps the request to the right tool and hands back a finished asset.

Account

Confirm your key works and check how much quota is left.

whoami

Verify your API key and return the account, granted scopes, and subscription status. The best first call.

β€œCheck that my EzUGC key is connected and what it can do.”

get_usage

See how much of your video and image quota you've used this cycle, what's left, and your plan status.

β€œHow much EzUGC quota do I have left this month?”

Video

Generate clips, UGC ads, and on-brand videos with any model.

list_video_models

Browse every available video model with its capabilities, supported durations, and whether it accepts a start image.

β€œList the EzUGC video models I can use.”

generate_video

Create a video with any model β€” text-to-video or image-to-video β€” and optionally ground it in a saved brand.

β€œMake an 8s cinematic clip of a coffee pour.”

generate_ugc_video

Produce a full creator-style ad β€” script, avatar, voiceover, and captions β€” straight from a brief.

β€œCreate a 20s UGC ad for my new running shoe.”

generate_brand_video

One-shot on-brand video grounded in your saved brand's logo, colors, tone, and products.

β€œCreate a 15s launch teaser for my brand.”

Image ads

Produce static image ads from prompts or your brand identity.

list_image_models

Browse every static image-ad model with its reference-image support and supported aspect ratios.

β€œWhat image-ad models are available?”

generate_image_ad

Produce 1–4 static image ads from a prompt, optionally guided by reference images or a saved brand.

β€œGenerate 4 square ad images for a summer sale.”

generate_brand_image_ad

One-shot on-brand static image ad grounded in your saved brand's identity.

β€œCreate an on-brand image ad announcing free shipping.”

Brands

Save a brand from a website and ground every generation in it.

list_brands

List your saved brand workspaces with their status, website, brand name, and logos.

β€œShow me the brands I've saved.”

create_brand

Ingest a website URL to extract brand DNA β€” logo, colors, tone, and value props β€” into a saved brand.

β€œAdd my brand from https://acme.com.”

get_brand

Read a brand's status and extracted profile: brand book, tone, value props, colors, logos, and product images.

β€œShow the brand profile for Acme.”

get_brand_assets

List a brand's uploaded assets and previously generated creatives so they can be reused as references.

β€œList the assets saved for my brand.”

update_brand_md

Edit the brand book (the brand DNA used to ground on-brand generations) and optionally its tone of voice.

β€œUpdate my brand book to emphasize sustainability.”

Skills

Reusable prompt templates your agent can save and run on demand.

list_skills

List your saved skills β€” reusable parameterized prompt templates that dispatch generation jobs.

β€œWhat saved skills do I have?”

create_skill

Save a reusable prompt template with variable tokens and default settings for video, UGC, or image jobs.

β€œSave a skill that makes a 9:16 product teaser.”

get_skill

Read a single saved skill by id, including its template and defaults.

β€œShow me my 'product teaser' skill.”

update_skill

Edit a saved skill in place β€” tweak its prompt template or default settings without recreating it.

β€œChange my teaser skill to default to 10 seconds.”

delete_skill

Permanently remove a saved skill you no longer need.

β€œDelete my old 'holiday promo' skill.”

run_skill

Fill in a skill's variables, merge any overrides, and dispatch the generation it was built for.

β€œRun my teaser skill for the new sneaker line.”

list_agent_skills

Browse the read-only catalog of capabilities the conversational agent can use, with their parameters.

β€œWhat can the EzUGC agent do?”

Jobs & history

Review past work and poll long-running generations.

list_jobs

Browse your recent generation history β€” video, UGC, image-ad, and subtitle jobs β€” with status and result links.

β€œShow my last 10 generations.”

get_job

Check the status and result of a single job by id β€” useful for polling work you started in the background.

β€œIs my video job done yet?”

Subtitles

Burn captions onto a finished video.

generate_subtitled_video

Burn styled captions onto a video β€” either a finished UGC job or any public video URL plus its script.

β€œAdd bold TikTok-style captions to my last UGC video.”

24/7 agent

Schedule autonomous runs and link a chat channel for delivery.

create_agent_schedule

Set up a recurring or one-off autonomous run that fires a prompt on a schedule and can deliver to a chat.

β€œEvery Monday at 9am, draft a fresh ad concept for me.”

list_agent_schedules

List your scheduled autonomous runs with their cadence, next fire time, and last run.

β€œWhat automations do I have running?”

pause_agent_schedule

Pause a scheduled run to stop future autonomous fires, or resume it later β€” without deleting it.

β€œPause my Monday concept automation.”

list_channel_accounts

List the messaging accounts linked for 24/7 agent delivery, such as connected chats.

β€œWhich chats are linked to my agent?”

create_channel_link_token

Generate a short-lived code to link a chat so the agent can message you and deliver scheduled results.

β€œGive me a code to link my chat to the agent.”

New tools ship regularly. See the full, current set on npm (@ezugc/mcp).

Works with the agents you already use

Any client that speaks the Model Context Protocol over stdio can run the EzUGC server.

Claude Code
Cursor
Claude Desktop
Cline
Any MCP client

Built for how teams ship creative

E-commerce & DTC

Save your store as a brand once, then turn product pages into on-brand video and image ads from a single prompt.

Social & paid teams

Spin up hook variations for TikTok, Reels, and Shorts inside the agent that already runs your daily workflow.

Filmmaking & concepting

Compare models, draft cinematic shots, and iterate on look and motion without switching tools.

24/7 scheduled agent

Run generations on a schedule and deliver finished creative to a linked chat while you sleep.

Agencies

Keep one brand workspace per client and reuse saved skills so every operator ships consistent output.

Builders & automations

Wire EzUGC generation into your own agents, scripts, and pipelines through one standard protocol.

MCP server FAQs

What teams ask before connecting EzUGC to their agent.

It is a Model Context Protocol server, published as @ezugc/mcp, that lets Claude Code, Cursor, Claude Desktop, or any MCP client generate EzUGC videos and image ads and manage saved brands from a chat with your agent. It calls the EzUGC API on your behalf.
Anyone on a paid EzUGC plan. The server authenticates with an EzUGC API key (an ezk_live_ key) that you generate from your dashboard once your subscription is active. Free accounts cannot generate a key.
Any client that speaks the Model Context Protocol over stdio. That includes Claude Code, Cursor, and Claude Desktop, plus other MCP-compatible agents and editors.
Ask your agent to list the video or image models, then pass one to a generate tool. The catalog spans many image and video models and updates on our side, so new models appear without changing your setup.
Yes. Save a brand once from your website and EzUGC extracts your logo, colors, tone, and products. After that, the brand tools ground every video and image ad in that identity automatically.
MCP generations draw from the same video and image quota as your EzUGC plan. There is no separate charge for using the server β€” you can check remaining quota at any time by asking your agent.
The server runs locally through your client and authenticates only with your API key, which stays on your machine. It never uses browser sessions or app cookies, and you can revoke the key from your dashboard at any time.

Put EzUGC inside your agent

Generate your API key, add @ezugc/mcp to your client, and make on-brand video and image ads without leaving the chat.

Generate your API key