Broll MCP server
io.github.luke-fairbanks/broll·v0.1.1·5 starsContent studio MCP for coding agents: BYO keys, deterministic video rendering, draft-first posting
5 stars36 downloads/wk
Reviews
Write oneNobody has reviewed Broll yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Broll tools (14, 4 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
broll_statusReport workspace location, ffmpeg availability, configured generation providers, and social platform readiness. Call this first to see what is possible. Pass probe: true to live-verify social credentials (makes real authenticated API calls, posts nothing).
create_post_draftwrite actionCreate a reviewable post draft (text + media + target platforms). Validates against per-platform rules (char limits, media counts/sizes) and reports violations. Nothing is published — drafts are files the user can inspect; use publish_post to send.
create_thread_draftwrite actionCreate a multi-post thread draft. On publish, posts chain as replies under the first one (Bluesky reply refs, X in_reply_to). Each post has its own text and up to 4 images, validated per platform. Nothing is published until publish_post with confirm: true.
extract_frameExtract a single PNG frame from a video at a timestamp — use it to visually QA a render.
generate_imageGenerate image(s) with the user’s own API keys (BYO-key: OpenAI or Gemini; falls back to a labelled mock when no keys are set). Returns workspace asset ids usable in render_video, render_carousel, and post drafts.
generate_videoGenerate a short video clip with the user’s own API keys (Gemini Veo when configured; labelled mock otherwise). Expensive with real keys — only call when the user’s workflow needs generated footage.
import_assetCopy a local file (image/video/audio) into the broll workspace and get an asset id for it.
list_assetsList workspace assets (generated, imported, and rendered), optionally filtered by kind.
list_draftsList post drafts in the outbox with status and publish results.
probe_assetInspect a media file: duration, dimensions, codecs, streams. Accepts an asset id or absolute path.
publish_postwrite actionPublish a draft to its target platforms. Requires confirm: true — never call this without the user’s explicit go-ahead in the conversation. Platforms without credentials fail independently with setup instructions; "export" always succeeds and writes a ready-to-post bundle.
render_carouselRender branded carousel slides (the Instagram/LinkedIn format). Layout, fonts, accent bar, page numbers, and watermark are deterministic code; backgrounds can be plain color or any image asset. Returns one asset per slide.
render_videoCompile a declarative RenderPlan into an mp4 via ffmpeg — deterministic, brand-aware, no generation keys needed. Clips (video/image/color) are concatenated in order; overlays and captions are burned in; optional music is mixed under clip audio. Returns the rendered asset id.
set_profilewrite actionUpdate the Bluesky profile (display name, bio, avatar image) — merges with the existing profile, never clobbers other fields. Requires confirm: true because it changes the public account.
Public scan report
scanner v0.1.9 · 2026-09-26 · same rubric, same numbers if you re-run it
- Code scan57 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 75 days ago12/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How Broll compares
Against every graded Media MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 78/100
- higher than 58% of 1,337 Media servers
- Tools
- 14
- the typical Media server has 7
- Tools that change things
- 29%
- typical: 4%. Fewer write tools means less an agent can break
- GitHub stars
- 5
- more than 82% of 715 Media servers
- Downloads a week
- 36
- more than 19% of 365 Media servers with a package
What its tools let an agent do: 7 read · 5 create · 1 change · 1 send or post
Install Broll in Claude Code, Cursor or VS Code
Runs npx -y broll-mcp on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add broll -- npx -y broll-mcp
What the publisher says
From the Broll repository's README, as published. We do not edit it. Read it on GitHub
broll
The content studio MCP for coding agents. broll gives Claude Code, Codex, and any MCP client real hands for content work: generate media with your own API keys, render videos and carousels deterministically with code, and publish through a draft-first outbox.
The model plans. Code renders. Nothing posts without confirmation.
Why
Every developer running a coding agent hits the same wall: the agent can write the marketing plan, but it can't make the carousel, cut the video, or post it. Existing tools are credit-metered schedulers built for social media managers. broll is built for developers:
- BYO keys, no markup. Image/video generation uses your OPENAIAPIKEY / GEMINIAPIKEY directly. broll never proxies your inference or resells credits. A built-in mock provider keeps every workflow runnable before you add any keys.
- Deterministic rendering. Videos and slides are compiled from declarative plans into exact ffmpeg/sharp invocations. Same plan + same inputs = same output. When AI output drifts, the fix is code — so layout, fonts, captions, and branding live in code.
- Draft-first publishing. Posts are reviewable JSON files in an outbox. publish_post requires confirm: true, validates per-platform rules (char limits, media counts, file sizes) before anything leaves the machine, and reports per-platform results. The export platform always works: it writes a ready-to-post bundle.
Install
Requires Node 20+ and ffmpeg (brew install ffmpeg).
cd broll
npm install && npm run buildRegister with Claude Code (or use the checked-in .mcp.json when working inside this repo):
claude mcp add broll -- node /path/to/broll/dist/index.jsOptional environment:
Brand kit: drop a broll.config.json next to where the server runs (see this repo's for an example) — name, handle, colors, font, logo. Every render picks it up automatically.
Tools
Try it
npm run smokedrives the real server through a real MCP client: generates a background, renders a 3-slide carousel and a 9:16 teaser video with captions, extracts a QA frame, then drafts and "publishes" an export bundle — all into ./.broll/.
broll cloud (waitlist)
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Broll: common questions
- Is Broll MCP server safe?
- Mostly: it is graded B (78/100). Read the Broll safety report
- How do I install Broll?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Broll need an API key?
- Yes. The registry entry asks for
OPENAI_API_KEY,GEMINI_API_KEY,BLUESKY_APP_PASSWORD,MASTODON_ACCESS_TOKENand 4 more. - Is Broll maintained?
- The last commit was 115 days ago (2026-07-12). The latest release is v0.1.1.
- What can I use instead of Broll?
- Servers from other publishers that do the same job: SuperCMO MCP server, Sapiens Sintéticos MCP server and TokPortal MCP server. Compare all Broll alternatives.
- How does Broll compare with other Media MCP servers?
- safety score 78/100 (higher than 58% of 1,337 Media servers); tools 14 (the typical Media server has 7); tools that change things 29% (typical: 4%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to Broll
Same job from other publishers: the closest match first, then the best rated.
- SuperCMOMarketing media generation — image, video, voice — for AI agents. BYO keys.not reviewedEstablishedB
Sapiens SintéticosOperate your Sapiens Sintéticos AI studio: generate image, article, voice, music and video.not reviewedGrowingA
TokPortalManaged TikTok/Instagram/YouTube accounts + video posting at scale, operated by human managers.not reviewedGrowingA- BeatDesignLocal-first open-source AI media workbench with Canvas, video editor, Assets, and MCP tools.not reviewedGrowingB
Instavar Video Templates and StudioFree Remotion and HyperFrames templates and creative guides; optional hosted Studio workflows.not reviewedGrowingA