Distribea Mcp

io.github.DistribeaPublished by GitHub account Distribeav2.1.0Updated Oct 26, 2026

Generate images, video, music and voice from your CLI or AI agent. On-brand AI media toolkit.

VerifiedStreamable HTTPWeb executableDeveloper ToolsMedia & Design

Overview

AI-generated overview

Distribea generates on-brand images, video, music and voice from plain-language prompts, and can fill or rebrand a whole page's imagery from your AI agent.

What you can do
  • Generate media: one image, video clip, music track or voice-over from a short subject prompt, optionally with a chosen model or a reference photo.
  • Fill and rebrand pages: replace placeholders or stock images across a page or whole project with on-brand images, patched into the markup, with a free proposal first.
  • Edit and finish images: retouch, remove background, upscale, extend, fix missing alt text and convert heavy images to WebP.
  • Brand and catalog: lock a site style, build a logo/favicon/og:image pack, lock recurring characters or products, and browse the model catalog with indicative prices.
When to use it
Useful when a project needs real imagery or audio rather than stock photos or placeholders: landing pages, product shots, blog covers, hero clips, background music and voice-overs, or rebranding an existing site while working in an AI coding agent.
Requirements
Runs as a remote endpoint or as a local npm package (npx distribea-mcp) needing Node.js. Requires a Distribea account and plan; authentication is OAuth via browser login, or a personal access key supplied as the DISTRIBEA_MCP_KEY environment variable or an Authorization bearer header. Network access to the hosted engine is required.
Before you install
Generation is billed in credits on your Distribea plan, and video, music and voice need a paid plan; use the dry-run option to see the price first. The access key (DISTRIBEA_MCP_KEY or Authorization) is a credential and should be kept out of shared config. Page and rebrand tools write into your project files, though originals are kept as .original. Requests send your brief, a short excerpt of the page, a hashed project id and any file you ask to edit to the hosted engine and its AI providers.

Installation

In SourceWeft

  1. Open Distribea Mcp in the dashboard and add it to a workspace.
  2. Connect the required credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.Distribea%2Fdistribea-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config. The client completes OAuth sign-in on first connect.

{
  "mcpServers": {
    "distribea": {
      "type": "http",
      "url": "https://distribea.com/api/mcp/remote"
    }
  }
}

README

Distribea

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

[npm version] [npm downloads] [MCP registry] [License: MIT] [GitHub stars]

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

Distribea remakes any video with you in it (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-mcpdistribea login                                       # opens your browser — no key to paste
distribea image "founder portrait, soft daylight"  --portraitdistribea video "slow waves rolling at golden hour" --landscapedistribea 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

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

MediaCommandWhat you get
🖼️ Imagedistribea image "<subject>"One on-brand image (png/jpg), any aspect ratio. Portraits, heroes, product shots, illustrations, review avatars.
🎬 Videodistribea video "<subject>"One short clip (mp4) — text-to-video, or image-to-video from a reference photo.
🎵 Musicdistribea music "<style>"One royalty-ready track (mp3) — intros, backing music, ad beds.
🎙️ Voicedistribea voice "<text>"One voice-over (mp3), text-to-speech in many languages.
📄 A whole pagedistribea page [path]Every <img> placeholder on a page (or the whole project) filled on-brand, in parallel, patched into your code.
✍️ Blog coverdistribea blog "<article>"A 16:9 cover image that illustrates the article's actual subject, in your style, + alt text.

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

Raw-model CLI / MCPGeneric image MCPDistribea
Image · video · music · voice⚠️ varies❌ image only✅ all four, one connector
Lives in your terminal & your agent⚠️ one of them⚠️ MCP only✅ CLI · MCP · Skill
Writes the art direction for you❌ you prompt each model⚠️ prompt by prompt✅ built-in art director
Locks your brand once❌⚠️ per prompt✅ applied everywhere
Same face across scenes❌❌✅ recurring characters
Fills a whole page in one call❌❌✅ distribea page
Production-ready (WebP + SEO alt)❌❌✅ automatic
No keys/secrets in the connector⚠️ holds your model keys⚠️ varies✅ browser sign-in, nothing to paste

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)

bash
npm install -g distribea-mcpdistribea 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:

json
{  "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.

ToolWhere to add it
Claude Codeclaude mcp add distribea-mcp -e DISTRIBEA_MCP_KEY=dmcp_… -- npx -y distribea-mcp@latest
CursorSettings → MCP → Add, or paste the block into ~/.cursor/mcp.json
WindsurfPaste into ~/.codeium/windsurf/mcp_config.json
VS Code (Copilot)Paste into .vscode/mcp.json
ReplitAdd as a custom MCP server with the command above

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.

bash
npx skills add Distribea/distribea-mcp

Quickstart

bash
npm install -g distribea-mcpdistribea logindistribea 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

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

Standalone video (text-to-video)

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

Background music

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

Voice-over (text-to-speech)

bash
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.

bash
distribea image "the same product on a marble kitchen counter" --ref ./bottle.jpgdistribea 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.

bash
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.

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

Browse the live catalog (free)

bash
distribea models image      # or: video | music | voice

Dress a whole page

The 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.

bash
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.

bash
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 across the site.

Models

Generation runs on best-in-class providers, with a strong on-brand default per media type — so you rarely need to name one:

TypeDefaultA few of the providers available
ImageNano Banana Pro (2K)Nano Banana Pro · Seedream · Z-Image · Grok Image
VideoGrok Imagine (6s, 720p)Grok · Seedance · Veo · Sora
MusicMiniMax MusicMiniMax · CassetteAI
VoiceElevenLabs Multilingual v2ElevenLabs · MiniMax

The 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.

Command reference

CommandPurpose
distribea login [key]Connect — opens your browser; or pass a dmcp_… key directly
distribea whoami · logoutCheck / forget the saved session
distribea image "<subject>"One downloadable image (png/jpg)
distribea video "<subject>"One downloadable video (mp4)
distribea music "<style>"One downloadable track (mp3)
distribea voice "<text>"One downloadable voice-over (mp3)
distribea page [path]Fill a page (or the whole project) — placeholders → on-brand images
distribea blog "<article>"Article cover (16:9 + alt text)
distribea models [type]Browse the live catalog: image · video · music · voice
distribea call <tool> --k vCall any advanced MCP tool directly (see MCP tools)

Run distribea help for the full reference.

Flags

FlagPurpose
--model <id>Pick a specific model (see distribea models)
--ref <file>Reference image — image-to-image / image-to-video (repeat for several)
--format <r>16:9 (landscape) · 9:16 (portrait) · 1:1 (square)
--portrait · --landscape · --squareOrientation shortcuts
--lang <code>Voice language (e.g. en, fr)
--out <dir>Where to download the file
--jpgImage as jpg instead of png
--dry-runQuote only (0 credits) — shows the price, generates nothing

MCP tools

When 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.

ToolWhat it does
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)
bring_aliveMake an existing site feel alive: add images where sections have none and replace stock/old pictures on-brand (free proposal first, reversible)
generate_imageOne on-brand image (auto-switches to UGC selfie mode for review avatars)
generate_with_modelStandalone image with a chosen model + settings, downloaded as a native png/jpg
generate_videoStandalone video with a chosen model, downloaded as a native mp4
generate_musicStandalone music track, downloaded as mp3
generate_voiceStandalone voice-over (text-to-speech), downloaded as mp3
list_models · list_video_models · list_music_models · list_voice_modelsBrowse the catalog (ids, strengths, options, indicative prices) before generating (free)
edit_imageRetouch, redo, remove background, upscale ×4, extend
blog_coverGenerate an on-brand cover image for a blog article
site_styleLock, refine or anchor the site's visual identity
brand_packLogo, favicon pack and og:image in one call
create_referenceLock a recurring character (real photo supported) or product
finish_imagesFix missing ALT texts and convert heavy images to WebP (free)
pack_statusCurrent style, characters, credits
list_projects · link_project · forget_projectSave, reconnect or wipe a project's brand memory (free)

How it works

  1. You give a subject — a CLI command, or your agent calls a tool while it builds.
  2. The art director expands it into a full, on-brand prompt using your locked style — so you never hand-write the "how".
  3. The best-fit model generates the asset (or the one you named with --model).
  4. 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.

Every 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.

Billing & cost

  • 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.
  • 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.
  • 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.

Privacy & security

This 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:

  • 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.
  • 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.
  • Third parties: assets are produced through Distribea's hosted AI providers solely to fulfil your request. Your data is never sold.
  • Authentication: calls are authenticated with your personal key (dmcp_…), issued and revocable at distribea.com/account/mcp.
  • Retention & contact: data is kept for the life of your account; full policy and contact at distribea.com/legal/privacy-policy.

FAQ

What is Distribea MCP? An 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.

Which AI coding tools does it work with? Claude Code, Cursor, Windsurf, Replit and GitHub Copilot — anything that speaks MCP. It also runs as a plain CLI in any terminal.

Do I need an API key? No. 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.

Is it free? The 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.

Can it generate video, music and voice — or only images? All four: image, video, music and voice, through one connector.

How is it different from a raw image model or a generic image MCP? A 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.

Can it use my own photos? Yes. 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.

Will it modify my code or files? Only 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.

What formats and aspect ratios does it produce? Downloaded 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.

How do I see the price before generating? Add --dry-run (CLI) or dry_run (MCP). It quotes the exact credit cost and generates nothing (0 credits).

A call says it's still rendering — will I be charged twice? No. Video, music and voice take longer; re-run the exact same command to pick the result up. You are never charged twice.

Which models does it use? Strong 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.

Troubleshooting

No Distribea key / Not authenticated — run distribea login (or set DISTRIBEA_MCP_KEY for an MCP/hosted setup).

Unknown model "<name>" — run distribea models image|video|music|voice for the current catalog.

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.

Updating

bash
npm install -g distribea-mcp@latest

The MCP server pulls @latest automatically through npx, so agent setups stay current on their own.

Support

Bugs and feature requests: github.com/Distribea/distribea-mcp/issues. Key and docs: distribea.com/account/mcp.

License

MIT

© Distribea · distribea.com

Source: README.md at commit a8712ea

Tools

0
This server asks you to sign in, so SourceWeft could not read its tools without an account and has not indexed them. What a connected account sees can depend on that account and its permissions.

Version history

1
  1. v2.1.0LatestSep 16, 2026

Score

85% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts