{
  "markdown": "<div align=\"center\">\n\n# Distribea\n\n### Generate images, video, music &amp; voice — right inside your terminal and your AI agent.\n\n[![npm version](https://img.shields.io/npm/v/distribea-mcp?style=flat-square&color=2563eb&label=npm)](https://www.npmjs.com/package/distribea-mcp)\n[![npm downloads](https://img.shields.io/npm/dm/distribea-mcp?style=flat-square&color=2563eb)](https://www.npmjs.com/package/distribea-mcp)\n[![MCP registry](https://img.shields.io/badge/MCP-registry-2563eb?style=flat-square)](https://registry.modelcontextprotocol.io)\n[![License: MIT](https://img.shields.io/badge/License-MIT-2563eb?style=flat-square)](LICENSE)\n[![GitHub stars](https://img.shields.io/github/stars/Distribea/distribea-mcp?style=social)](https://github.com/Distribea/distribea-mcp/stargazers)\n\n**CLI · MCP server · Claude Skill** — works with Claude Code · Cursor · Windsurf · Replit · Copilot\n\n</div>\n\n**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**.\n\n```bash\nnpm install -g distribea-mcp\ndistribea login                                       # opens your browser — no key to paste\n\ndistribea image \"founder portrait, soft daylight\"  --portrait\ndistribea video \"slow waves rolling at golden hour\" --landscape\ndistribea music \"warm lo-fi beat, mellow, 90 bpm\"\ndistribea voice \"Welcome to our store.\"             --lang en\n```\n\nEach 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).\n\n---\n\n## Contents\n\n- [What is Distribea](#what-is-distribea)\n- [What you can make](#what-you-can-make)\n- [When to use Distribea](#when-to-use-distribea)\n- [Why Distribea](#why-distribea)\n- [Install](#install)\n- [Quickstart](#quickstart)\n- [Examples &amp; recipes](#examples--recipes)\n- [Dress a whole page](#dress-a-whole-page)\n- [Recurring faces &amp; products](#recurring-faces--products)\n- [Models](#models)\n- [Command reference](#command-reference)\n- [Flags](#flags)\n- [MCP tools](#mcp-tools)\n- [How it works](#how-it-works)\n- [Billing &amp; cost](#billing--cost)\n- [Privacy &amp; security](#privacy--security)\n- [FAQ](#faq)\n- [Troubleshooting](#troubleshooting)\n- [Updating](#updating)\n- [Support](#support)\n- [License](#license)\n\n## What is Distribea\n\nMost 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**.\n\n- **One connector, four media types.** Image, video, music *and* voice through a single install. Most tools stop at images.\n- **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.\n- **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\".\n- **Production-ready.** Images come out as optimised WebP with proper SEO alt text, downloaded for you or patched straight into your page.\n\nThe 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.\n\n## What you can make\n\n| Media | Command | What you get |\n|---|---|---|\n| 🖼️ **Image** | `distribea image \"<subject>\"` | One on-brand image (png/jpg), any aspect ratio. Portraits, heroes, product shots, illustrations, review avatars. |\n| 🎬 **Video** | `distribea video \"<subject>\"` | One short clip (mp4) — text-to-video, or image-to-video from a reference photo. |\n| 🎵 **Music** | `distribea music \"<style>\"` | One royalty-ready track (mp3) — intros, backing music, ad beds. |\n| 🎙️ **Voice** | `distribea voice \"<text>\"` | One voice-over (mp3), text-to-speech in many languages. |\n| 📄 **A whole page** | `distribea page [path]` | Every `<img>` placeholder on a page (or the whole project) filled on-brand, in parallel, patched into your code. |\n| ✍️ **Blog cover** | `distribea blog \"<article>\"` | A 16:9 cover image that illustrates the article's actual subject, in your style, + alt text. |\n\n## When to use Distribea\n\nReach 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:\n\n- You're **building a landing page** and need real, on-brand images — not stock.\n- You need **e-commerce product shots** that stay consistent across the catalog.\n- You want a **hero image, team portraits, or testimonial avatars** with believable faces.\n- You're **writing a blog post** and need a cover image matched to the article and your style.\n- You need a **short video clip** (text-to-video or image-to-video) for a hero or ad.\n- You need **background music** for an intro, demo, or ad.\n- You need a **voice-over** for a demo, walkthrough, or video narration.\n- You have a site full of **cheap or off-brand stock photos** and want to rebrand them in place.\n- You're **vibe coding with an AI agent** and want it to fill in media on its own as it builds.\n\n## Why Distribea\n\n| | Raw-model CLI / MCP | Generic image MCP | **Distribea** |\n|---|:---:|:---:|:---:|\n| Image · video · music · voice | ⚠️ varies | ❌ image only | ✅ all four, one connector |\n| Lives in your terminal &amp; your agent | ⚠️ one of them | ⚠️ MCP only | ✅ CLI · MCP · Skill |\n| Writes the art direction for you | ❌ you prompt each model | ⚠️ prompt by prompt | ✅ built-in art director |\n| Locks your brand once | ❌ | ⚠️ per prompt | ✅ applied everywhere |\n| Same face across scenes | ❌ | ❌ | ✅ recurring characters |\n| Fills a whole page in one call | ❌ | ❌ | ✅ `distribea page` |\n| Production-ready (WebP + SEO alt) | ❌ | ❌ | ✅ automatic |\n| No keys/secrets in the connector | ⚠️ holds your model keys | ⚠️ varies | ✅ browser sign-in, nothing to paste |\n\n**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.\n\n## Install\n\nA [Distribea](https://distribea.com) plan powers generation (free/trial accounts get a couple of gift images to try it). The connector itself is free and stores no secrets.\n\n### CLI (recommended)\n\n```bash\nnpm install -g distribea-mcp\ndistribea login          # opens your browser, click Authorize — no key to paste\n```\n\n`distribea whoami` confirms you're connected.\n\n### MCP server\n\nDrop this into the `.mcp.json` at the root of your project:\n\n```json\n{\n  \"mcpServers\": {\n    \"distribea-mcp\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"distribea-mcp@latest\"],\n      \"env\": {\n        \"DISTRIBEA_MCP_KEY\": \"dmcp_…\"\n      }\n    }\n  }\n}\n```\n\nGrab your `dmcp_…` key at [distribea.com/account/mcp](https://distribea.com/account/mcp). If you've already run `distribea login`, the server reuses that session and you can omit the `env` block entirely.\n\n| Tool | Where to add it |\n|---|---|\n| **Claude Code** | `claude mcp add distribea-mcp -e DISTRIBEA_MCP_KEY=dmcp_… -- npx -y distribea-mcp@latest` |\n| **Cursor** | Settings → MCP → Add, or paste the block into `~/.cursor/mcp.json` |\n| **Windsurf** | Paste into `~/.codeium/windsurf/mcp_config.json` |\n| **VS Code (Copilot)** | Paste into `.vscode/mcp.json` |\n| **Replit** | Add as a custom MCP server with the command above |\n\n### Claude Skill\n\nThe package ships `SKILL.md`. Add it once and your agent reaches for Distribea on its own whenever a page needs imagery or audio.\n\n```bash\nnpx skills add Distribea/distribea-mcp\n```\n\n## Quickstart\n\n```bash\nnpm install -g distribea-mcp\ndistribea login\ndistribea image \"a quiet beach at sunrise, warm light\" --landscape\n```\n\nThe 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.\n\n## Examples &amp; recipes\n\nEvery command takes a plain-language subject. Add `--dry-run` to preview the price first (0 credits, generates nothing).\n\n### On-brand image\n\n```bash\ndistribea image \"founder portrait, soft daylight, neutral background\" --portrait\n```\n\n### Standalone video (text-to-video)\n\n```bash\ndistribea video \"slow waves rolling onto a tropical beach\" --landscape\n```\n\n### Background music\n\n```bash\ndistribea music \"warm lo-fi beat, mellow, 90 bpm\" --out ./assets\n```\n\n### Voice-over (text-to-speech)\n\n```bash\ndistribea voice \"Welcome to our store — let's get you started.\" --lang en\n```\n\n### Reference photo → image or video (image-to-image / image-to-video)\n\nTurn 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.\n\n```bash\ndistribea image \"the same product on a marble kitchen counter\" --ref ./bottle.jpg\ndistribea video \"gentle push-in on the cliff at golden hour\" --ref ./cliff.jpg --portrait\n```\n\n### Blog cover\n\nReads the article and illustrates its specific subject, matched to your locked style, as a 16:9 WebP + alt text.\n\n```bash\ndistribea blog \"How we cut our build times in half — full article body here…\"\n```\n\n### Pick a specific model\n\nDefaults are strong; only name a model when you want a particular one.\n\n```bash\ndistribea image \"minimalist blue logo on white\" --model nano-banana-pro --dry-run\n```\n\n### Browse the live catalog (free)\n\n```bash\ndistribea models image      # or: video | music | voice\n```\n\n## Dress a whole page\n\nThe page workflow is the superpower. Build your page with `<img src=\"https://placehold.co/1200x600\">` 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.\n\n```bash\ndistribea page ./index.html      # omit the path to dress the whole project\n```\n\nEvery 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.\n\nAlready 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`).\n\n## Recurring faces &amp; products\n\nA 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**.\n\n```bash\ndistribea image \"the teacher explaining at a whiteboard\" --ref ./founder.jpg\n```\n\nNever 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 across the site.\n\n## Models\n\nGeneration runs on best-in-class providers, with a strong on-brand default per media type — so you rarely need to name one:\n\n| Type | Default | A few of the providers available |\n|---|---|---|\n| Image | Nano Banana Pro (2K) | Nano Banana Pro · Seedream · Z-Image · Grok Image |\n| Video | Grok Imagine (6s, 720p) | Grok · Seedance · Veo · Sora |\n| Music | MiniMax Music | MiniMax · CassetteAI |\n| Voice | ElevenLabs Multilingual v2 | ElevenLabs · MiniMax |\n\nThe catalog is live — browse current models, what each is best at, their options and indicative prices with `distribea models image|video|music|voice` (free), or `list_models` / `list_video_models` / `list_music_models` / `list_voice_models` over MCP.\n\n## Command reference\n\n| Command | Purpose |\n|---|---|\n| `distribea login` `[key]` | Connect — opens your browser; or pass a `dmcp_…` key directly |\n| `distribea whoami` · `logout` | Check / forget the saved session |\n| `distribea image \"<subject>\"` | One downloadable image (png/jpg) |\n| `distribea video \"<subject>\"` | One downloadable video (mp4) |\n| `distribea music \"<style>\"` | One downloadable track (mp3) |\n| `distribea voice \"<text>\"` | One downloadable voice-over (mp3) |\n| `distribea page` `[path]` | Fill a page (or the whole project) — placeholders → on-brand images |\n| `distribea blog \"<article>\"` | Article cover (16:9 + alt text) |\n| `distribea models` `[type]` | Browse the live catalog: `image` · `video` · `music` · `voice` |\n| `distribea call <tool> --k v` | Call any advanced MCP tool directly (see [MCP tools](#mcp-tools)) |\n\nRun `distribea help` for the full reference.\n\n## Flags\n\n| Flag | Purpose |\n|---|---|\n| `--model <id>` | Pick a specific model (see `distribea models`) |\n| `--ref <file>` | Reference image — image-to-image / image-to-video (repeat for several) |\n| `--format <r>` | `16:9` (landscape) · `9:16` (portrait) · `1:1` (square) |\n| `--portrait` · `--landscape` · `--square` | Orientation shortcuts |\n| `--lang <code>` | Voice language (e.g. `en`, `fr`) |\n| `--out <dir>` | Where to download the file |\n| `--jpg` | Image as jpg instead of png |\n| `--dry-run` | Quote only (0 credits) — shows the price, generates nothing |\n\n## MCP tools\n\nWhen used as an MCP server, the same engine exposes these tools to your agent. The agent picks the right one for the job; you just describe what you need.\n\n| Tool | What it does |\n|---|---|\n| `make_images` ⭐ | Fill every placeholder/stock slot of a page (or the whole project) with on-brand images, in parallel; or rebrand existing images in place (`rebrand: true`) |\n| `bring_alive` | Make an existing site feel alive: add images where sections have none and replace stock/old pictures on-brand (free proposal first, reversible) |\n| `generate_image` | One on-brand image (auto-switches to UGC selfie mode for review avatars) |\n| `generate_with_model` | Standalone image with a chosen model + settings, downloaded as a native png/jpg |\n| `generate_video` | Standalone video with a chosen model, downloaded as a native mp4 |\n| `generate_music` | Standalone music track, downloaded as mp3 |\n| `generate_voice` | Standalone voice-over (text-to-speech), downloaded as mp3 |\n| `list_models` · `list_video_models` · `list_music_models` · `list_voice_models` | Browse the catalog (ids, strengths, options, indicative prices) before generating (free) |\n| `edit_image` | Retouch, redo, remove background, upscale ×4, extend |\n| `blog_cover` | Generate an on-brand cover image for a blog article |\n| `site_style` | Lock, refine or anchor the site's visual identity |\n| `brand_pack` | Logo, favicon pack and og:image in one call |\n| `create_reference` | Lock a recurring character (real photo supported) or product |\n| `finish_images` | Fix missing ALT texts and convert heavy images to WebP (free) |\n| `pack_status` | Current style, characters, credits |\n| `list_projects` · `link_project` · `forget_project` | Save, reconnect or wipe a project's brand memory (free) |\n\n## How it works\n\n1. **You give a subject** — a CLI command, or your agent calls a tool while it builds.\n2. **The art director expands it** into a full, on-brand prompt using your locked style — so you never hand-write the \"how\".\n3. **The best-fit model generates** the asset (or the one you named with `--model`).\n4. **You get a finished file** — downloaded to a tidy folder, or patched into your page as optimised WebP with SEO alt text, originals kept safe.\n\nEvery batch is **quoted in credits before it runs**; `--dry-run` (CLI) or `dry_run` (MCP) previews the price and generates nothing. The connector runs locally and holds no secrets; your brand memory, generated assets, and billing live on the hosted Distribea engine.\n\n## Billing &amp; cost\n\n- Generation is billed in credits on your Distribea plan; every batch is quoted in credits before it starts — use `--dry-run` (CLI) or `dry_run` (MCP) to preview the price first.\n- Video, music and voice need a paid plan and take longer to render. If a call says it's still rendering, run it again with the same settings to pick it up — **you are never charged twice**.\n- One `page` call dresses a page; the job is then done. Distribea won't regenerate or \"improve\" assets on its own — retouch only when you ask.\n\n## Privacy &amp; security\n\nThis local connector contains **no API keys and no secrets**. To generate an asset it sends to the hosted Distribea engine only what is needed for the request:\n\n- **What is sent:** your brief (the subject you ask for), a short text excerpt of the page being worked on (to infer the site's style and context), a hashed project identifier, and any file you explicitly ask to edit. **Your other project files stay on your machine** — they are never read or uploaded.\n- **What is stored, tied to your account:** your locked visual style, recurring characters/products/avatars, the assets generated for you (hosted on Distribea's CDN), and your credit/billing usage.\n- **Third parties:** assets are produced through Distribea's hosted AI providers solely to fulfil your request. Your data is **never sold**.\n- **Authentication:** calls are authenticated with your personal key (`dmcp_…`), issued and revocable at [distribea.com/account/mcp](https://distribea.com/account/mcp).\n- **Retention &amp; contact:** data is kept for the life of your account; full policy and contact at [distribea.com/legal/privacy-policy](https://distribea.com/legal/privacy-policy).\n\n## FAQ\n\n**What is Distribea MCP?**\nAn on-brand AI media toolkit that generates images, video, music and voice from plain-language prompts, available as a CLI, an MCP server, and a Claude Skill. It ships production-ready assets (WebP + SEO alt text) at the regular site price.\n\n**Which AI coding tools does it work with?**\nClaude Code, Cursor, Windsurf, Replit and GitHub Copilot — anything that speaks MCP. It also runs as a plain CLI in any terminal.\n\n**Do I need an API key?**\nNo. `distribea login` signs you in through the browser — nothing to paste. For an MCP/hosted setup you use a personal `dmcp_…` key, issued and revocable in your account.\n\n**Is it free?**\nThe connector is free and stores no secrets. Generation is billed in credits on your Distribea plan; free and trial accounts get a couple of gift images to try it.\n\n**Can it generate video, music and voice — or only images?**\nAll four: image, video, music and voice, through one connector.\n\n**How is it different from a raw image model or a generic image MCP?**\nA built-in art director writes the prompt from your one-line subject, your brand is locked once and applied everywhere, faces and products stay identical across shots, and a single call can fill an entire page — patched into your code as WebP with SEO alt text.\n\n**Can it use my own photos?**\nYes. Pass `--ref` for image-to-image or image-to-video, and lock a person or product so the same face/object appears in every scene while the staging changes.\n\n**Will it modify my code or files?**\nOnly files you point it at. `distribea page` fills placeholders and patches them into your markup; when rebranding existing images it keeps the originals as `*.original`. Your other files are never read or uploaded.\n\n**What formats and aspect ratios does it produce?**\nDownloaded assets are native png/jpg (image), mp4 (video), mp3 (music/voice); images placed in a page come out as optimised WebP. Orientations: `16:9`, `9:16`, `1:1`.\n\n**How do I see the price before generating?**\nAdd `--dry-run` (CLI) or `dry_run` (MCP). It quotes the exact credit cost and generates nothing (0 credits).\n\n**A call says it's still rendering — will I be charged twice?**\nNo. Video, music and voice take longer; re-run the exact same command to pick the result up. You are never charged twice.\n\n**Which models does it use?**\nStrong on-brand defaults per media type (e.g. Nano Banana Pro for images, Grok Imagine for video, MiniMax for music, ElevenLabs for voice), with a live catalog you can browse and override with `--model`.\n\n## Troubleshooting\n\n**`No Distribea key` / `Not authenticated`** — run `distribea login` (or set `DISTRIBEA_MCP_KEY` for an MCP/hosted setup).\n\n**`Unknown model \"<name>\"`** — run `distribea models image|video|music|voice` for the current catalog.\n\n**A call says it's still rendering** — video/music/voice take longer; re-run the exact same command to pick the result up. You are never charged twice.\n\n## Updating\n\n```bash\nnpm install -g distribea-mcp@latest\n```\n\nThe MCP server pulls `@latest` automatically through `npx`, so agent setups stay current on their own.\n\n## Support\n\nBugs and feature requests: [github.com/Distribea/distribea-mcp/issues](https://github.com/Distribea/distribea-mcp/issues). Key and docs: [distribea.com/account/mcp](https://distribea.com/account/mcp).\n\n## License\n\n[MIT](LICENSE)\n\n<div align=\"center\">\n\n© Distribea · [distribea.com](https://distribea.com)\n\n</div>\n",
  "bytes": 21635,
  "sha": "7fe6bb153de4c8caae84ceb1d83ab9378e8c0c137971bec1a7b4f9b8655fb697",
  "repo_slug": "distribea/distribea-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_distribea_distribea_mcp_e67507fc/readme"
}