# Distribea
### Generate images, video, music & voice — right inside your terminal and your AI agent.
[](https://www.npmjs.com/package/distribea-mcp)
[](https://www.npmjs.com/package/distribea-mcp)
[](https://registry.modelcontextprotocol.io)
[](LICENSE)
[](https://github.com/Distribea/distribea-mcp/stargazers)
**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**.
```bash
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-is-distribea)
- [What you can make](#what-you-can-make)
- [When to use Distribea](#when-to-use-distribea)
- [Why Distribea](#why-distribea)
- [Install](#install)
- [Quickstart](#quickstart)
- [Examples & recipes](#examples--recipes)
- [Dress a whole page](#dress-a-whole-page)
- [Recurring faces & products](#recurring-faces--products)
- [Models](#models)
- [Command reference](#command-reference)
- [Flags](#flags)
- [MCP tools](#mcp-tools)
- [How it works](#how-it-works)
- [Billing & cost](#billing--cost)
- [Privacy & security](#privacy--security)
- [FAQ](#faq)
- [Troubleshooting](#troubleshooting)
- [Updating](#updating)
- [Support](#support)
- [License](#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
| Media | Command | What you get |
|---|---|---|
| 🖼️ **Image** | `distribea image ""` | One on-brand image (png/jpg), any aspect ratio. Portraits, heroes, product shots, illustrations, review avatars. |
| 🎬 **Video** | `distribea video ""` | One short clip (mp4) — text-to-video, or image-to-video from a reference photo. |
| 🎵 **Music** | `distribea music "