Distribea is an 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…"