How do I install Broll?

Broll is a local plugin. Install it using npm package: broll-mcp and add the generated configuration snippet to your AI app's MCP config file. Then restart your AI app.

Is Broll safe to use?

Yes. Broll passed MCP Marketplace's automated security scan with a score of 10/10 (low risk). Every server on MCP Marketplace is security-scanned before it's listed; see the full security report on this page for the findings and permissions.

What credentials does Broll need?

Broll requires the following credentials or environment variables: OPENAI_API_KEY, GEMINI_API_KEY, BLUESKY_IDENTIFIER, BLUESKY_APP_PASSWORD, MASTODON_ACCESS_TOKEN, X_API_KEY, X_API_SECRET, X_ACCESS_TOKEN, X_ACCESS_TOKEN_SECRET. You can find setup instructions on the server detail page.

What AI apps work with Broll?

Broll uses the Model Context Protocol (MCP) and works with any MCP-compatible AI app, including Claude, ChatGPT / Codex, Gemini, Copilot, Cursor, and more.

Back to Browse

Broll MCP Server

by Luke Fairbanks

Developer ToolsLow Risk10.0MCP RegistryLocal

Free

Server data from the Official MCP Registry

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

About

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

Security Report

10.0

Low Risk10.0Low Risk

Valid MCP server (2 strong, 1 medium validity signals). No known CVEs in dependencies. Package registry verified. Imported from the Official MCP Registry.

7 files analyzed · 1 issue found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

file_system

Check that this permission is expected for this type of plugin.

env_vars

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

Optional: gpt-image-1 image generationRequired

Environment variable: OPENAI_API_KEY

Optional: Imagen images + Veo videoRequired

Environment variable: GEMINI_API_KEY

Optional: Bluesky handle for live postingOptional

Environment variable: BLUESKY_IDENTIFIER

Optional: Bluesky app passwordRequired

Environment variable: BLUESKY_APP_PASSWORD

Optional: Mastodon app token for live postingRequired

Environment variable: MASTODON_ACCESS_TOKEN

Optional: X consumer key (posting requires funded API credits)Required

Environment variable: X_API_KEY

Optional: X consumer secretRequired

Environment variable: X_API_SECRET

Optional: X access token (Read and write)Required

Environment variable: X_ACCESS_TOKEN

Optional: X access token secretRequired

Environment variable: X_ACCESS_TOKEN_SECRET

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-luke-fairbanks-broll": {
      "env": {
        "X_API_KEY": "your-x-api-key-here",
        "X_API_SECRET": "your-x-api-secret-here",
        "GEMINI_API_KEY": "your-gemini-api-key-here",
        "OPENAI_API_KEY": "your-openai-api-key-here",
        "X_ACCESS_TOKEN": "your-x-access-token-here",
        "BLUESKY_IDENTIFIER": "your-bluesky-identifier-here",
        "BLUESKY_APP_PASSWORD": "your-bluesky-app-password-here",
        "MASTODON_ACCESS_TOKEN": "your-mastodon-access-token-here",
        "X_ACCESS_TOKEN_SECRET": "your-x-access-token-secret-here"
      },
      "args": [
        "-y",
        "broll-mcp"
      ],
      "command": "npx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

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 OPENAI_API_KEY / GEMINI_API_KEY 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

claude mcp add broll -- node /path/to/broll/dist/index.js

Optional environment:

Variable	Purpose
`OPENAI_API_KEY`	gpt-image-1 image generation
`GEMINI_API_KEY`	Imagen images + Veo video generation
`BLUESKY_IDENTIFIER` / `BLUESKY_APP_PASSWORD`	live Bluesky posting (use an app password)
`MASTODON_ACCESS_TOKEN` (+ optional `MASTODON_INSTANCE`)	live Mastodon posting — no app review, any instance
`X_API_KEY` / `X_API_SECRET` / `X_ACCESS_TOKEN` / `X_ACCESS_TOKEN_SECRET`	live X posting (free API tier works)
`BROLL_HOME`	workspace location (default `~/.broll`)
`BROLL_FFMPEG` / `BROLL_FFPROBE`	explicit binary paths

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

Tool	What it does
`broll_status`	Workspace, ffmpeg, provider + platform readiness. Call first.
`generate_image` / `generate_video`	BYO-key generation → workspace assets (mock fallback when keyless)
`import_asset` / `list_assets` / `probe_asset`	Bring in and inspect media
`render_video`	Declarative RenderPlan → mp4: clips (video/image/color), trims, cover/contain fits, burned-in titles + timed captions, music bed, 9:16 / 1:1 / 4:5 / 16:9
`render_carousel`	Branded slide sets (the Instagram/LinkedIn format): kicker, headline, body, accent bar, page numbers, watermark — layout is 100% code
`extract_frame`	Pull a PNG frame so the agent can visually QA its own render
`create_post_draft`	Text + media + platforms → validated, reviewable draft in the outbox
`list_drafts` / `publish_post`	Inspect the outbox; publish with explicit `confirm: true`

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)

The local server you're looking at stays MIT and free. broll cloud adds the parts a local server can't do well: the app-review-walled platforms (Instagram, LinkedIn, TikTok) through broll's own approved credentials, schedules that run while your laptop is closed, and a swipe-to-approve inbox on your phone. ~$29/mo when it ships.

Join the waitlist → 👍 issue #1 — subscribers get the launch note; comments set the platform build order.

Safety model

Nothing is published without a draft file on disk first.
publish_post hard-requires confirm: true — agents are instructed to obtain the user's explicit go-ahead.
Constraint violations block publishing; they never auto-truncate your text.
Keys are read from your environment and sent only to their own vendor's API.

Status & roadmap

Early but real: 96 tests including real-ffmpeg integration renders and a full MCP round trip.

Bluesky video upload
X chunked video upload
LinkedIn adapter (needs app review)
Mastodon adapter
YouTube Shorts via user OAuth
Ken Burns / crossfade transitions
Word-level caption timing from transcripts
npx broll-mcp distribution

Development

npm test          # unit + integration (real ffmpeg)
npm run typecheck
npm run smoke     # end-to-end artifact check

MIT.

Reviews

No reviews yet

Be the first to review this server!

More Developer Tools MCP Servers

Fetch

Free

by Modelcontextprotocol · Developer Tools

Web content fetching and conversion for efficient LLM usage

Git

Free

by Modelcontextprotocol · Developer Tools

Read, search, and manipulate Git repositories programmatically

Toleno

Free

by Toleno · Developer Tools

Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.

mcp-creator-python

Free

by mcp-marketplace · Developer Tools

Create, build, and publish Python MCP servers to PyPI — conversationally.

MCP Marketplace

Free

by mcp-marketplace · Developer Tools

Search and install MCP servers from inside your AI client.

MarkItDown

Free

by Microsoft · Content & Media

Convert files (PDF, Word, Excel, images, audio) to Markdown for LLM consumption

Broll MCP Server

About

Security Report

Findings (1)

Permissions Required

What You'll Need

How to Install

Documentation

broll

Why

Install

Tools

Try it

broll cloud (waitlist)

Safety model

Status & roadmap

Development

Reviews

No reviews yet

More Developer Tools MCP Servers

Fetch

Git

Toleno

mcp-creator-python

MCP Marketplace

MarkItDown