MCP.Market

Broll MCP server

by luke-fairbanks·io.github.luke-fairbanks/broll·v0.1.1·5 stars

Content studio MCP for coding agents: BYO keys, deterministic video rendering, draft-first posting

B78/100grade B
What users say
No reviews yet
Be the first
Safety scan
B78/100

full report

Adoption
Growing

5 stars36 downloads/wk

Reviews

Write one

Nobody 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 posts

Read from the package source without running it. The installed server may list more.

  • broll_status

    Report 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 action

    Create 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 action

    Create 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_frame

    Extract a single PNG frame from a video at a timestamp — use it to visually QA a render.

  • generate_image

    Generate 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_video

    Generate 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_asset

    Copy a local file (image/video/audio) into the broll workspace and get an asset id for it.

  • list_assets

    List workspace assets (generated, imported, and rendered), optionally filtered by kind.

  • list_drafts

    List post drafts in the outbox with status and publish results.

  • probe_asset

    Inspect a media file: duration, dimensions, codecs, streams. Accepts an asset id or absolute path.

  • publish_postwrite action

    Publish 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_carousel

    Render 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_video

    Compile 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 action

    Update 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

no findings
  • 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
Overall 78/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

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
Add to Cursor

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 build

Register 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.js

Optional 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 smoke

drives 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_TOKEN and 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.

All Broll alternatives →
  • SuperCMO
    Marketing media generation — image, video, voice — for AI agents. BYO keys.
    B
  • Sapiens Sintéticos
    Operate your Sapiens Sintéticos AI studio: generate image, article, voice, music and video.
    A
  • TokPortal
    Managed TikTok/Instagram/YouTube accounts + video posting at scale, operated by human managers.
    A
  • BeatDesign
    Local-first open-source AI media workbench with Canvas, video editor, Assets, and MCP tools.
    B
  • Instavar Video Templates and Studio
    Free Remotion and HyperFrames templates and creative guides; optional hosted Studio workflows.
    A