Distribea MCP

Distribea

Generate images, video, music & voice — right inside your terminal and your AI agent.

CLI · MCP server · Claude Skill — works with Claude Code · Cursor · Windsurf · Replit · Copilot

[Distribea](https://distribea.com) remakes any video with you in it ([Motion Control](https://distribea.com/ai/motion-control)) and gives a royalty-free library of music, sound effects, footage and images. This package is its on-brand AI media toolkit for builders: it generates images, video, music and voice from plain-language prompts and ships them production-ready — optimised WebP with SEO alt text, downloaded for you or patched straight into your code. One connector, four media types, reachable three ways: a CLI in your terminal, an MCP server your AI coding agent calls while it builds, and a Claude Skill. Define your brand once; a built-in AI art director writes every prompt — you say what you want, never how to render it. Billed in credits at the regular site price; the connector holds no API keys and no secrets.

npm install -g distribea-mcp

distribea login # opens your browser — no key to paste

distribea image "founder portrait, soft daylight" --portrait distribea video "slow waves rolling at golden hour" --landscape distribea music "warm lo-fi beat, mellow, 90 bpm" distribea voice "Welcome to our store." --lang en

Each file lands in a tidy folder, ready to use. Add --dry-run to any command to see the exact credit price first (0 credits, generates nothing).

Contents

• What is Distribea
• What you can make
• When to use Distribea
• Why Distribea
• Install
• Quickstart
• Examples & recipes
• Dress a whole page
• Recurring faces & products
• Models
• Command reference
• Flags
• MCP tools
• How it works
• Billing & cost
• Privacy & security
• FAQ
• Troubleshooting
• Updating
• Support
• License

What is Distribea

Most AI media tools hand you a raw model and a blank prompt box, in a browser tab, one image at a time. Distribea is the layer above that — and it lives where you build.

• One connector, four media types. Image, video, music *and* voice through a single install. Most tools stop at images.
• Three ways in, one engine. Run it from your shell (distribea …), drop it into your AI agent as an MCP server (Claude Code, Cursor, Windsurf, Replit, Copilot), or add the Claude Skill so the model reaches for it on its own.
• On-brand by default. Lock your brand once and every asset matches it. The art director turns a one-line subject into a full prompt — you never write the "how".
• Production-ready. Images come out as optimised WebP with proper SEO alt text, downloaded for you or patched straight into your page.

The heavy lifting — art direction, generation, billing — runs on the hosted Distribea engine. This package is only the local connector: it scans and patches your files, holds no API keys and no secrets, and bills generation in credits on your Distribea plan at the regular site price.

What you can make

When to use Distribea

Reach for Distribea whenever a project needs imagery or audio and you'd otherwise ship stock photos, gray placeholders, CSS-gradient-only sections, or a raw pasted photo. Typical jobs:

• You're building a landing page and need real, on-brand images — not stock.
• You need e-commerce product shots that stay consistent across the catalog.
• You want a hero image, team portraits, or testimonial avatars with believable faces.
• You're writing a blog post and need a cover image matched to the article and your style.
• You need a short video clip (text-to-video or image-to-video) for a hero or ad.
• You need background music for an intro, demo, or ad.
• You need a voice-over for a demo, walkthrough, or video narration.
• You have a site full of cheap or off-brand stock photos and want to rebrand them in place.
• You're vibe coding with an AI agent and want it to fill in media on its own as it builds.

Why Distribea

In one line: other tools give you a model and a prompt box; Distribea gives you finished, on-brand assets — in the four media types you actually need — without leaving the place you build.

Install

A Distribea plan powers generation (free/trial accounts get a couple of gift images to try it). The connector itself is free and stores no secrets.

CLI (recommended)

npm install -g distribea-mcp

distribea login # opens your browser, click Authorize — no key to paste

distribea whoami confirms you're connected.

MCP server

Drop this into the .mcp.json at the root of your project:

{

"mcpServers": { "distribea-mcp": { "command": "npx", "args": ["-y", "distribea-mcp@latest"], "env": { "DISTRIBEA_MCP_KEY": "dmcp_…" } } } }

Grab your dmcp_… key at distribea.com/account/mcp. If you've already run distribea login, the server reuses that session and you can omit the env block entirely.

Claude Skill

The package ships SKILL.md. Add it once and your agent reaches for Distribea on its own whenever a page needs imagery or audio.

npx skills add Distribea/distribea-mcp

Quickstart

npm install -g distribea-mcp

distribea login distribea image "a quiet beach at sunrise, warm light" --landscape

The file lands in a tidy folder, ready to use. That's it — no model to pick, no prompt engineering: the style is inferred and the art director writes the prompt. From here, swap image for video, music, or voice, or run distribea page to dress a whole page at once.

Examples & recipes

Every command takes a plain-language subject. Add --dry-run to preview the price first (0 credits, generates nothing).

On-brand image

distribea image "founder portrait, soft daylight, neutral background" --portrait

Standalone video (text-to-video)

distribea video "slow waves rolling onto a tropical beach" --landscape

Background music

distribea music "warm lo-fi beat, mellow, 90 bpm" --out ./assets

Voice-over (text-to-speech)

distribea voice "Welcome to our store — let's get you started." --lang en

Reference photo → image or video (image-to-image / image-to-video)

Turn a real photo into a new on-brand image or animate it. Pass --ref once, or several times for multiple references — automatically capped to what the chosen model accepts.

distribea image "the same product on a marble kitchen counter" --ref ./bottle.jpg

distribea video "gentle push-in on the cliff at golden hour" --ref ./cliff.jpg --portrait

Blog cover

Reads the article and illustrates its specific subject, matched to your locked style, as a 16:9 WebP + alt text.

distribea blog "How we cut our build times in half — full article body here…"

Pick a specific model

Defaults are strong; only name a model when you want a particular one.

distribea image "minimalist blue logo on white" --model nano-banana-pro --dry-run

Browse the live catalog (free)

distribea models image      # or: video | music | voice

Dress a whole page

The page workflow is the superpower. Build your page with markers wherever an image goes, then one call fills every slot with imagery that matches your brand — one consistent look across the whole site, recurring characters with the same face in every scene, believable UGC avatars for review sections.

distribea page ./index.html      # omit the path to dress the whole project

Every image lands production-ready: optimised WebP, proper SEO alt text, and patched straight into your code. No stock photos. No placeholders. No export step. The style is inferred from the page itself, so there's nothing to set up.

Already have a site with cheap or off-brand stock photos? Rebrand them in place — the first pass lists every replaceable image for free, then applies the new look without touching your code (originals kept as *.original).

Recurring faces & products

A real person (a founder, a teacher) or a product that must look identical in every shot is treated as a locked subject — the face/object stays 100% identical, only the staging changes.

distribea image "the teacher explaining at a whiteboard" --ref ./founder.jpg

Never paste a raw photo into the page: leave a placeholder and let the engine restage that exact face in your site's world. Review and testimonial avatars come out as casual smartphone selfies (UGC look); the same reviewer keeps the same face acros