bmdctl MCP server
Commit Nov 2, 2026Lets an AI client control Blackmagic Design production equipment including ATEM switchers, HyperDeck recorders, Videohub routers, and Ultimatte keyers.
Also known as lucas-romanenko/bmdctl
- Stars
- 9
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- —
- Last commit
- Nov 2, 2026
- License
- MIT
What is bmdctl MCP?
bmdctl lets an AI client control Blackmagic Design production equipment including ATEM switchers, HyperDeck recorders, Videohub routers, and Ultimatte keyers.
Summary generated from the project's README
About bmdctl MCP server
Managing live broadcast hardware through an AI client is possible with bmdctl. This tool allows engineers and studio operators to control Blackmagic Design equipment including ATEM switchers, HyperDeck recorders, Videohub routers, and Ultimatte keyers over a network. It functions as a single binary that communicates directly with devices using their native protocols, such as UDP 9910 for ATEM or TCP for other hardware, removing the need for the Blackmagic SDK or desktop software.
Users can deploy the server locally on macOS, Linux, or Windows, or run it in a Docker container to provide an HTTP API and MCP interface. When connected to an MCP client like Claude Desktop, the server provides specific tools for different command groups. To ensure safety during live productions, the system is designed so that destructive commands require human confirmation before they are executed. This setup enables automation via SSH, cron jobs, or show controllers while maintaining direct hardware communication.
What you can do with it
- 1Manage broadcast recording hardwareA developer can instruct an AI to control playback or recording functions on HyperDeck devices.
- 2Maintain production configurations in version controlEngineers can save switcher profiles and media pool settings to a git repository to track changes.
Written from the project's README. Every use case is checked against a quote from it.
Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablelucas-romanenko/bmdctl is public and reachablegithub.com/lucas-romanenko/bmdctl ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-02github.com/lucas-romanenko/bmdctl ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubbmdctl
bmdctl is one binary that controls Blackmagic Design production equipment over the network: ATEM switchers, HyperDeck recorders, Videohub routers and Ultimatte keyers. It talks each device's own protocol (UDP 9910 to an ATEM, TCP to the others), so no Blackmagic SDK, driver or ATEM Software Control is involved. A background engine keeps a session open to each switcher, deck and router, and every command is also served over HTTP and to AI agents over MCP.
It's for the people who run and automate studios, live events and broadcast rooms: an engineer at a terminal or over SSH, a cron job, a show controller such as Companion, or an AI agent, all with the same commands.
Run on an ATEM, a HyperDeck and an Ultimatte; Videohub ported, not yet run on a router.
$ bmdctl connect 192.168.1.20
STUDIO A PGM CAM2 · PVW CAM1 · 1080p25 · connected 328 ms
saved as "STUDIO A", now the default
$ bmdctl preview cam3
STUDIO A PGM CAM2 · PVW CAM1
preview CAM1 → CAM3 27 ms
$ bmdctl cut
STUDIO A PGM CAM2 · PVW CAM3
cut CAM3 on program · CAM2 on preview 30 ms
$ bmdctl status
STUDIO A 1080p25 · session 14s, idle 3s, pinned
ME 1 PGM CAM3 PVW CAM2
mix 1:00 · next background · FTB off
Install
macOS and Linux, into ~/.local/bin (/usr/local/bin as root), checked
against the release's checksums.txt:
curl -fsSL https://raw.githubusercontent.com/lucas-romanenko/bmdctl/main/install.sh | sh
- Windows (Scoop):
scoop install https://raw.githubusercontent.com/lucas-romanenko/bmdctl/main/scoop/bmdctl.json - Debian, Ubuntu, Fedora: the
.debor.rpmfrom the latest release (sudo apt install ./bmdctl_*_amd64.deb), with the man page and completions. - Docker:
ghcr.io/lucas-romanenko/bmdctl, which runs the engine and the HTTP API (docker run -d --network host -v bmdctl:/data ghcr.io/lucas-romanenko/bmdctl). - Go 1.27:
go install github.com/lucas-romanenko/bmdctl/cmd/bmdctl@latest
The releases also install atemctl, hdctl, vhctl and ultctl:
bmdctl for one device (hdctl play is bmdctl hyperdeck play).
docs/INSTALL.md covers PATH, completion, upgrading and
removal.
Quick start
bmdctl connect 192.168.1.20 # asks what answers there, saves it by its own name
bmdctl status # program, preview, transition, keyers, aux
bmdctl program cam2 # a number, cam2, mp1, bars, or the input's name
Why
- Control over SSH. Anything that can reach the switcher's network can run it from a shell: a jump host, a laptop on the VPN, a script. Nothing needs a desktop session or ATEM Software Control.
- Switcher configs in git.
bmdctl profile save show.xmlwrites ATEM Software Control's XML and the media pool stills beside it. Commit them, and a change to a show's setup is a diff. (profile restoreloads one back; parts of it have run on hardware, and docs/HARDWARE.md says which.) - AI agents over MCP.
bmdctl mcpgives Claude Code, Claude Desktop or any MCP client a tool per command group. Destructive commands do nothing until a person confirms. See docs/AGENTS.md.
Also:
- Scheduled changes: an
execcue file run from cron; every line is checked before the first is sent. - Show control: call
bmdctlfrom Companion's shell action, Node-RED's exec node or Home Assistant'sshell_command. - Tally:
bmdctl watch --jsonprints each program, preview and tally change as one JSON line. - Fleets: loop over
bmdctl hosts --jsonand run the same command, orprofile save, on every switcher. - Teaching and CI:
--dry-runprints a command's bytes with no switcher; the tests run against a fake switcher. - A Raspberry Pi (64-bit OS) beside the switcher can run the engine and the HTTP API (
bmdctl engine --serve).
Documentation
The documentation is also a site, https://lucas-romanenko.github.io/bmdctl/
(built from docs/ by mkdocs.yml).
- docs/GUIDE.md: a walkthrough, task by task, with what each command prints.
- docs/COMMANDS.md: every command and flag, generated
from the command table (
bmdctl manprints the same). - docs/AGENTS.md: the MCP server and the Claude skill.
- docs/HARDWARE.md: what has run on real hardware (an ATEM, a HyperDeck, an Ultimatte and a Videohub's routing) and what hasn't.
- docs/ARCHITECTURE.md: how the packages, the engine and the tests fit together.
- CONTRIBUTING.md: building, testing and adding a command.
Credits
- bmdwire, the Python original by the same author. bmdctl's device packages are a port of its libraries (atemwire, hyperdeckwire, videohubwire, ultimattewire), following v1.8.0.
- pyatem by Martijn Braam and the
OpenAtem contributors, for the ATEM protocol groundwork. atemwire, which
atem/ports, is a fork of it (atem/NOTICE). - Skaarhoj and the ATEM community, for early protocol notes.
Licence
bmdctl is MIT (LICENSE), except for two directories that are
LGPL-3.0-only: atem/ (atem/LICENSE), as atemwire, the
pyatem fork it ports, is, and internal/fixtures/, data copied from
atemwire's tests. NOTICE maps them.
Not affiliated with or endorsed by Blackmagic Design Pty Ltd. ATEM, HyperDeck, Videohub and Ultimatte are trademarks of Blackmagic Design.
bmdctl MCP questions
Does bmdctl require the Blackmagic SDK?
No, it uses native protocols to communicate with devices without needing the Blackmagic SDK, drivers, or ATEM Software Control.
Can I use bmdctl with AI agents?
Yes, the bmdctl mcp command provides tools to AI clients like Claude Desktop or Claude Code, with destructive commands requiring human confirmation.