ATEM MCP Server
Control Blackmagic ATEM video switchers via natural language commands through AI assistants (Claude, Cursor, etc.) using the Model Context Protocol (MCP).
Connection Management: Connect/disconnect by IP address and get switcher status (model, firmware, inputs).
Video Switching: Set program/preview inputs, perform cuts, auto transitions, fade to black, and set preview+transition in a single call.
Transition Control: Configure style (mix, dip, wipe, DVE, stinger), rate in frames, and manual T-bar positioning (0.0–1.0).
Routing & Keying: Route inputs to auxiliary outputs; control downstream (DSK) and upstream (USK) keyers for graphics and picture-in-picture effects.
Macros: Run, stop, continue, and list ATEM macros.
Recording & Streaming: Start/stop recording and streaming, and check their status.
Audio Mixing: Control input gain, balance, and mix mode (on/off/audio-follow-video) plus master output levels — for both Fairlight and Classic audio systems.
Fairlight Audio Processing: Advanced per-input parametric EQ, compression, limiting, and gating for compatible ATEM models, including EQ presets.
Super Source: Configure multi-box layouts (side-by-side, 2x2, PiP), art fills, borders, and save/recall custom looks. Includes gallery view and active-speaker auto-switching.
Flexible Deployment: Local stdio transport for Claude Desktop/Cursor, plus HTTP with OAuth 2.0 for remote access via claude.ai and Claude Mobile. Cloudflare Tunnel support for secure permanent remote access.
Live Production Ready: Immediate tool execution without approval prompts in supported clients, making it suitable for live show environments.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@ATEM MCP Server Set camera 2 on preview and dissolve to it"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
ATEM MCP Server
Control Blackmagic ATEM video switchers with AI assistants using the Model Context Protocol. Works with Claude Desktop, claude.ai, Claude Mobile, Cursor, and any MCP-compatible client.
Talk to your switcher in plain English: "Put camera 2 on program and dissolve to it" or "Start streaming and recording" or "Run macro 3."
Supports both local (stdio) and remote (Streamable HTTP with OAuth 2.0) transports.
How It Works
You (natural language)
│
▼
Claude (Anthropic Cloud)
│ translates to MCP tool calls
▼
ATEM MCP Server (your Mac/PC)
│ uses atem-connection library
▼
ATEM Switcher (network)
│ executes commands
▼
ATEM Software Control / hardware
│ reflects changes in real timeRelated MCP server: Resolve Claude MCP
Supported ATEM Models
The underlying atem-connection library (by NRK/Sofie) supports every ATEM generation:
ATEM Mini, Mini Pro, Mini Pro ISO, Mini Extreme, Mini Extreme ISO
ATEM Television Studio HD, HD8, HD8 ISO
ATEM 1 M/E, 2 M/E, 4 M/E Production Studio / Constellation
ATEM SDI, SDI Pro ISO, SDI Extreme ISO
And all other Blackmagic ATEM models
Quick Start
1. Install
cd atem-mcp-server
npm install
npm run build2. Configure Claude Desktop
Edit your Claude Desktop config file:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"atem": {
"command": "/opt/homebrew/bin/node",
"args": ["/path/to/atem-mcp-server/dist/index.js"],
"env": {
"ATEM_HOST": "192.168.1.100"
}
}
}
}Note: Replace
/opt/homebrew/bin/nodewith your full Node.js path (runwhich nodeto find it). Replace the IP with your ATEM's address.
3. Restart Claude Desktop
Quit and relaunch Claude Desktop. You should see the hammer (🔨) icon indicating MCP tools are available.
4. Start Talking to Your Switcher
"Connect to my ATEM at 192.168.1.100"
"Show me the current switcher status"
"Put camera 3 on preview and dissolve to it"
"Fade to black"
Environment Variables
Variable | Description | Default |
| ATEM IP address (enables auto-connect) | — |
| ATEM port |
|
| Transport mode: |
|
| HTTP server port (when |
|
| Public URL for OAuth endpoints (when behind a tunnel/proxy) |
|
If ATEM_HOST is set, the server auto-connects on startup. Otherwise, use atem_connect to connect manually.
Remote Access (claude.ai, Claude Mobile, HTTP)
The HTTP transport exposes the MCP server as a web endpoint with built-in OAuth 2.0. This enables remote access from claude.ai, Claude Mobile, and any HTTP-capable MCP client.
Quick Start (HTTP Mode)
TRANSPORT=http BASE_URL=https://atem.yourdomain.com ATEM_HOST=192.168.1.100 node dist/index.jsThe server starts on port 3000 with:
MCP endpoint:
POST /mcp(Bearer token required)OAuth 2.0: Full auto-provisioning flow (discovery, registration, authorization, token exchange)
Health check:
GET /health
Connect from claude.ai
Click Add custom connector
Enter your MCP URL (e.g.,
https://atem.yourdomain.com/mcp)Click Connect — the OAuth flow completes automatically
Start a conversation and control your ATEM remotely
Connect from Claude Desktop (Remote)
{
"mcpServers": {
"atem": {
"url": "https://atem.yourdomain.com/mcp"
}
}
}No command or args needed — the server runs remotely.
OAuth 2.0 Implementation
The HTTP server implements a complete OAuth 2.0 flow for MCP authentication:
Endpoint | Purpose |
| RFC 9728 resource metadata |
| Authorization server metadata |
| Dynamic Client Registration (DCR) |
| Authorization endpoint (auto-approves) |
| Token exchange (issues Bearer tokens) |
The OAuth server auto-provisions tokens without user interaction — designed for personal/trusted use. For production environments, consider adding proper authentication.
Expose with Cloudflare Tunnel
Use a named Cloudflare Tunnel for a permanent URL — no port forwarding, no dynamic DNS, no changing URLs.
Prerequisites
A free Cloudflare account
A domain managed by Cloudflare DNS
cloudflaredCLI installed (brew install cloudflaredon macOS)
Setup
1. Authenticate and create tunnel
cloudflared login
cloudflared tunnel create atem-mcpNote the tunnel ID (a UUID).
2. Route DNS
cloudflared tunnel route dns atem-mcp atem.yourdomain.com3. Create config file (~/.cloudflared/config.yml)
tunnel: <TUNNEL_ID>
credentials-file: ~/.cloudflared/<TUNNEL_ID>.json
ingress:
- hostname: atem.yourdomain.com
service: http://localhost:3000
- service: http_status:4044. Start the server and tunnel
# Terminal 1: MCP server
TRANSPORT=http BASE_URL=https://atem.yourdomain.com ATEM_HOST=192.168.1.100 node dist/index.js
# Terminal 2: Cloudflare tunnel
cloudflared tunnel run atem-mcpYour MCP endpoint is now live at https://atem.yourdomain.com/mcp.
Critical: Disable Cloudflare AI Bot Blocking
If you use Cloudflare and connect from claude.ai, you must disable AI bot blocking or claude.ai's requests will be silently blocked with a 403.
Claude.ai's backend uses the Claude-User user agent from Google Cloud Platform IPs. Cloudflare's "Block AI training bots" managed rule blocks these requests before they reach your server.
To fix:
Go to Cloudflare Dashboard > select your domain
On the Overview page, find "Block AI training bots" on the right sidebar
Change from "Block on all pages" to "Do not block (allow crawlers)"
You can verify in Security > Analytics > Events — blocked requests show as Service: Managed rules, Rule: Manage AI bots, User agent: Claude-User.
Run as a Background Service (macOS)
sudo cloudflared service installThis creates a launch daemon that starts the tunnel on boot.
Useful Commands
cloudflared tunnel list # List all tunnels
cloudflared tunnel info atem-mcp # Show tunnel details
cloudflared tunnel cleanup atem-mcp # Remove stale connections
cloudflared tunnel delete atem-mcp # Delete the tunnel entirelyAvailable Tools (58 tools)
Connection
Tool | Description |
| Connect to an ATEM switcher by IP |
| Disconnect from the ATEM |
| Get model, inputs, program/preview state |
Switching
Tool | Description |
| Set program (live) input |
| Set preview (next) input |
| Hard cut transition |
| Auto transition (dissolve/wipe/etc.) |
| Toggle Fade to Black |
| Set preview + auto transition in one call |
Transitions
Tool | Description |
| Set mix, dip, wipe, DVE, or stinger |
| Set transition duration in frames |
| Manual T-bar position (0.0–1.0) |
| Get current transition settings |
Routing & Keyers
Tool | Description |
| Route input to aux output |
| Get current aux routing |
| Downstream keyer on/off air |
| Auto transition for DSK |
| Set DSK fill and key sources |
| Upstream keyer on/off air |
| Set USK fill and cut sources |
Macros
Tool | Description |
| Run a macro by index |
| Stop running macro |
| Continue paused macro |
| List all defined macros |
Recording & Streaming
Tool | Description |
| Start recording |
| Stop recording |
| Start streaming |
| Stop streaming |
| Get recording/streaming status |
Super Source
Tool | Description |
| Get all box positions, sources, art, and border settings |
| Configure a single box (source, position, size, crop) |
| Set layout with presets (side-by-side, 2x2 grid, PiP, etc.) |
| Configure art fill/cut source, foreground/background |
| Configure border width, color, bevel, light source |
| 2x2 gallery grid: host + 3 guests, prioritizes active speakers via audio levels |
| Cut full-screen to whoever is currently talking (detected via audio levels) |
| Start auto-switching: program mode (full-screen), ssrc_box mode (Super Source box), or host_ssrc mode (host full-screen + guest side-by-side) |
| Stop auto-switching mode |
| Check if auto-switch is running, see stats |
| Save current Super Source layout as a named "look" (boxes, art, border) |
| Load a saved look and apply it — optionally override sources for different guests |
| List all saved looks with descriptions and box counts |
| Delete a saved look |
Audio Mixer (Fairlight + Classic)
Audio tools auto-detect the mixer type. Fairlight is used on ATEM Mini Extreme, Constellation, and newer models. Classic is used on ATEM Mini, Mini Pro, and older models.
Tool | Description |
| Set input gain, fader, balance, mix mode (Fairlight or Classic) |
| Set master output gain/fader |
| Get full audio mixer state (reports mixer type) |
Fairlight EQ & Dynamics
Full parametric EQ, compressor, limiter, and gate/expander control for ATEM models with Fairlight audio (Mini Extreme, Constellation, and newer). Includes EQ presets for common use cases.
Tool | Description |
| Set individual EQ band (shape, frequency, gain, Q) on an input |
| Apply EQ preset: vocal, podcast, music, de_mud, or flat |
| Set compressor (threshold, ratio, attack, hold, release) |
| Set limiter (threshold, attack, hold, release) |
| Set noise gate/expander (threshold, range, ratio, attack, release) |
| Get full EQ + dynamics state for an input |
| Set EQ band on master output |
| Set compressor on master output |
| Set limiter on master output |
| Set makeup gain on an input |
| Reset compressor/limiter/gate to factory defaults |
| Reset EQ to factory defaults |
Common Input IDs
ID | Source |
1–20 | Physical SDI/HDMI inputs |
1000 | Color Bars |
2001 | Color Generator 1 |
2002 | Color Generator 2 |
3010 | Media Player 1 |
3011 | Media Player 1 Key |
3020 | Media Player 2 |
3021 | Media Player 2 Key |
6000 | Super Source |
10010 | Black |
10011 | Clean Feed 1 (Program) |
10012 | Clean Feed 2 |
Example Conversations
Basic switching:
"Put camera 1 on program"
"Set preview to camera 3 and do a 2-second dissolve"
"Cut to color bars"
Show setup:
"Set transition style to mix with a 45-frame rate"
"Route camera 1 to aux 1 for the confidence monitor"
"Put DSK1 on air for the lower third graphic"
Streaming/Recording:
"Start streaming and recording"
"What's the recording status?"
"Stop streaming but keep recording"
Audio (Fairlight & Classic):
"Lower camera 2 audio by 5 dB" "Set camera 1 audio to audio-follow-video mode" "Mute audio on input 3" "Set master output to -3dB" "Show me the audio mixer state"
Fairlight EQ & Dynamics:
"Apply vocal EQ preset to mic 1" "Boost presence at 3kHz on camera 2 audio" "Add a compressor to mic 1 — 4:1 ratio, threshold at -20dB" "Gate mic 2 so it cuts off below -40dB" "Put a limiter on the master at -3dB" "Show me the EQ and dynamics state for input 1" "Reset all EQ on camera 1 to flat"
Gallery & Active Speaker:
"Go gallery" "Go gallery with guests on cameras 2, 3, and 5" "Cut to active speaker" "Auto switch" (starts following the active speaker continuously) "Auto switch host + active speaker" (host full-screen when talking, side-by-side when guest talks) "Auto switch off" "Set up a side-by-side with cameras 1 and 2" "Cut to host with 3"
Save & Recall Looks:
"Save this look as podcast4" "Load podcast4" "Load podcast4 with cameras 2, 3, 6, 7" (reuses layout geometry with different sources) "What looks do I have saved?" "Delete the old_test look"
Architecture
This server uses the atem-connection library (by NRK/Sofie TV Automation) which implements Blackmagic's proprietary ATEM protocol over UDP. It's the same protocol that ATEM Software Control uses, so all changes are reflected in real time across all connected clients.
The MCP server wraps atem-connection methods as MCP tools that Claude (or any MCP-compatible AI) can call. Each tool maps to one or more ATEM commands.
Transport modes:
stdio (default) — for Claude Desktop, Cursor, and local MCP clients
HTTP (
TRANSPORT=http) — Streamable HTTP with OAuth 2.0, for claude.ai, Claude Mobile, and remote access. Uses Express + rawhttp.createServerfor proper header handling with the MCP SDK.
Production Resilience (systemd)
The server is configured to run as a systemd service for maximum reliability:
Service Configuration (~/.config/systemd/user/atem-mcp.service):
[Unit]
Description=ATEM MCP Server
After=network.target
[Service]
Type=simple
WorkingDirectory=/home/guycochran/atem-mcp-server
Environment="TRANSPORT=http"
Environment="PORT=3002"
Environment="BASE_URL=https://atem-mcp.cochran.cloud"
Environment="ATEM_HOST=192.168.8.237"
ExecStart=/usr/bin/node dist/index.js
Restart=always
RestartSec=10
[Install]
WantedBy=default.targetResilience Features:
Auto-starts on boot — Service enabled with
systemctl --user enable atem-mcpAuto-restarts on crash —
Restart=alwaysensures continuous operation10-second restart delay — Prevents rapid restart loops
Survives power outages — Automatically recovers when system boots
Proper shutdown handling — Gracefully closes ATEM connections
Service Management:
# Check status
systemctl --user status atem-mcp
# Start/stop/restart
systemctl --user start atem-mcp
systemctl --user stop atem-mcp
systemctl --user restart atem-mcp
# View logs
journalctl --user -u atem-mcp -f
# Enable auto-start on boot
systemctl --user enable atem-mcpLive Show Usage
When using this server to control an ATEM during a live production, you need every command to execute instantly — no confirmation dialogs, no approval prompts, no delays. The experience varies by client:
Client Behavior
Client | Tool Approval | Best For |
claude.ai | No approval needed — tools run immediately | Live shows, remote control |
Claude Mobile | No approval needed — tools run immediately | On-the-go control |
Claude Desktop | No approval needed — tools run immediately | Local production control |
Claude Code (CLI) | Requires approval for each tool call | Development and testing only |
Cursor | May require approval depending on settings | Development and testing |
For live production, use claude.ai, Claude Mobile, or Claude Desktop. These clients execute MCP tool calls without interruption — you say "cut to camera 2" and it happens immediately.
Claude Code (the terminal CLI) is designed for software development and has a safety system that prompts for approval before running tools. This is great for coding but unsuitable for live switching where every second counts.
Pre-Show Checklist
Run through this checklist before going live to catch issues early:
Verify connection — "Show me the switcher status"
Test switching — "Put camera 1 on preview, then cut to it"
Test transitions — "Set transition to mix at 30 frames and dissolve to camera 2"
Test audio — "Show me the audio mixer state"
Test recording/streaming — "Start recording" → verify → "Stop recording"
Test Super Source (if using) — "Set up a side-by-side with cameras 1 and 2"
Set your show defaults — transition style, rate, audio levels, EQ presets
Tips for Live Production
Set
ATEM_HOSTin your environment so the server auto-connects on startup — no need to manually connect each timeUse specific language — "Cut to camera 3" is faster than "Can you switch to the third camera please?"
Combine commands — "Put camera 2 on preview and dissolve to it" executes as a single
preview_and_autocallKeep a fallback — Always have ATEM Software Control or a hardware panel available in case of network issues
Troubleshooting
Hammer icon not showing in Claude Desktop:
Make sure you're using the full path to
node(runwhich node)Check logs:
~/Library/Logs/Claude/mcp*.logRestart Claude Desktop completely (quit, not just close window)
Can't connect to ATEM:
Verify the ATEM is on the same network
Try pinging the ATEM IP from terminal
Default ATEM port is 9910 (UDP)
Make sure ATEM Software Control isn't blocking the connection
claude.ai connector shows auth error:
Check Cloudflare "Block AI training bots" is set to "Do not block" (see Cloudflare section)
Check Security > Analytics > Events in Cloudflare dashboard for blocked requests
Verify
BASE_URLmatches your public tunnel URL exactlyTest with
curl -X POST https://your-url/mcp— should return 401 JSON (not 403 HTML)
HTTP server returns 406 Not Acceptable:
The MCP SDK requires
Accept: application/json, text/event-streambut some clients sendAccept: */*The server includes a built-in workaround that patches the Accept header at the raw HTTP level
Commands not working:
Some features require specific ATEM models (e.g., streaming/recording on Mini Pro+)
Check
atem_get_statusto verify connection
Credits
Guy Cochran (Office Hours Global) — Creator and project lead
Claude by Anthropic — AI pair-programming partner
atem-connection by NRK (Norwegian Broadcasting Corporation) — the ATEM protocol library
MCP TypeScript SDK by Anthropic
License
MIT
Available Tools
32 toolsatem_auto_dskAuto Downstream Key TransitionA
Trigger an auto transition for a downstream keyer (mix on/off air).
Args:
dsk (number): Downstream keyer number (0-based)
Inputs: dsk (required).
atem_auto_transitionAuto TransitionA
Trigger an auto transition (dissolve, wipe, etc.) from preview to program using the current transition settings.
Args:
me (number, optional): Mix Effect bus number (default: 0 for ME1)
Inputs: me.
atem_connectConnect to ATEM SwitcherAIdempotent
Connect to a Blackmagic ATEM video switcher on the network.
Args:
host (string): IP address of the ATEM switcher (e.g., "192.168.1.100")
port (number, optional): Port number (default: 9910)
Returns: Connection confirmation with ATEM model info.
Inputs: host (required), port.
atem_cutCut TransitionA
Perform a hard cut transition — instantly switches preview to program.
Args:
me (number, optional): Mix Effect bus number (default: 0 for ME1)
Inputs: me.
atem_disconnectDisconnect from ATEMAIdempotent
Disconnect from the currently connected ATEM switcher.
Inputs: no named parameters.
atem_fade_to_blackFade to BlackA
Toggle Fade to Black (FTB). If currently live, fades to black. If already in FTB, fades back up.
Args:
me (number, optional): Mix Effect bus number (default: 0 for ME1)
Inputs: me.
atem_get_audio_stateGet Audio Mixer StateARead-onlyIdempotent
Get the current audio mixer state including all input levels, mix options, and master output settings.
Returns: JSON object with master output settings and per-input audio state.
Inputs: no named parameters.
atem_get_aux_sourceGet Aux Output SourcesARead-onlyIdempotent
Get the current source routing for all auxiliary outputs.
Returns: JSON object mapping each aux output to its current source input.
Inputs: no named parameters.
atem_get_recording_statusGet Recording/Streaming StatusBRead-onlyIdempotent
Get the current recording and streaming status from the ATEM.
Inputs: no named parameters.
atem_get_statusGet ATEM StatusARead-onlyIdempotent
Get current ATEM switcher status including model info, current program/preview inputs, and connection state.
Returns: JSON object with model, firmware version, current program input, current preview input, and available inputs.
Inputs: no named parameters.
atem_get_transition_stateGet Transition StateARead-onlyIdempotent
Get current transition settings for a Mix Effect bus including style, rates, and in-transition status.
Args:
me (number, optional): Mix Effect bus number (default: 0 for ME1)
Returns: JSON with current transition style, rates per type, and whether a transition is currently in progress.
Inputs: me.
atem_list_macrosList MacrosARead-onlyIdempotent
List all defined macros on the ATEM switcher.
Returns: JSON array of macros with their index, name, and whether they are valid/used.
Inputs: no named parameters.
atem_macro_continueContinue MacroB
Continue a paused macro.
Inputs: no named parameters.
atem_macro_runRun MacroB
Run an ATEM macro by index number.
Args:
index (number): Macro slot number (0-based, so macro 0 = first macro slot)
Inputs: index (required).
atem_macro_stopStop MacroAIdempotent
Stop the currently running macro.
Inputs: no named parameters.
atem_preview_and_autoSet Preview and Auto TransitionA
Convenience tool: sets a preview input then immediately triggers an auto transition to bring it on air. Equivalent to selecting a source and pressing AUTO.
Args:
input (number): Input source number to transition to
me (number, optional): Mix Effect bus number (default: 0 for ME1)
Inputs: input (required), me.
atem_set_audio_master_outputSet Audio Master OutputBIdempotent
Configure the master audio output level.
Args:
gain (number, optional): Master output gain in dB (-60 to +6)
followFadeToBlack (boolean, optional): Whether master audio follows Fade to Black
Inputs: gain, followFadeToBlack.
atem_set_audio_mixer_inputSet Audio Input PropertiesAIdempotent
Configure an audio input on the ATEM's built-in audio mixer. Set gain, balance, and whether the input is on, off, or in audio-follow-video mode.
Args:
input (number): Audio input number (matches video input numbers)
mixOption (string, optional): "on" (always on), "off" (muted), or "afv" (audio-follow-video — audio is live only when this input is on program)
gain (number, optional): Gain in dB (-60 to +6)
balance (number, optional): Stereo balance (-1.0 = full left, 0 = center, 1.0 = full right)
Inputs: input (required), mixOption, gain, balance.
atem_set_aux_sourceSet Aux Output SourceAIdempotent
Route an input source to an auxiliary output.
Args:
aux (number): Aux output number (0-based, so aux 0 = Aux 1 on the switcher)
input (number): Input source number to route to this aux
Common uses: sending a clean feed to a recorder, routing a specific camera to a confidence monitor, etc.
Inputs: aux (required), input (required).
atem_set_dsk_on_airSet Downstream Key On AirAIdempotent
Put a downstream keyer on or off air. DSKs overlay graphics (logos, lower thirds, etc.) on top of the program output.
Args:
dsk (number): Downstream keyer number (0-based, 0 = DSK1, 1 = DSK2)
onAir (boolean): true to put on air, false to take off air
Inputs: dsk (required), onAir (required).
atem_set_dsk_sourcesSet DSK Fill and Key SourcesAIdempotent
Set the fill and/or key (cut) sources for a downstream keyer.
Args:
dsk (number): Downstream keyer number (0-based)
fillSource (number, optional): Input to use as fill source
cutSource (number, optional): Input to use as key/cut source
Inputs: dsk (required), fillSource, cutSource.
atem_set_previewSet Preview InputAIdempotent
Set the preview (next) input on the ATEM switcher.
Args:
input (number): Input source number (same IDs as atem_set_program)
me (number, optional): Mix Effect bus number (default: 0 for ME1)
Inputs: input (required), me.
atem_set_programSet Program InputAIdempotent
Set the program (live/on-air) input on the ATEM switcher.
Args:
input (number): Input source number (e.g., 1=Input 1, 2=Input 2, 1000=Color Bars, 2001=Color 1, 3010=Media Player 1, 3020=Media Player 2, 6000=Super Source, 10010=Black)
me (number, optional): Mix Effect bus number (default: 0 for ME1)
Common input IDs: 1-20 = physical inputs, 1000 = color bars, 2001/2002 = color generators, 3010/3020 = media players, 6000 = super source, 10010 = black.
Inputs: input (required), me.
atem_set_transition_positionSet Transition Position (T-Bar)AIdempotent
Manually set the transition position, like moving the T-bar. Useful for manual fades.
Args:
position (number): Position from 0.0 (preview) to 1.0 (program). 0 = fully on current program, 1 = fully transitioned to preview.
me (number, optional): Mix Effect bus number (default: 0 for ME1)
Inputs: position (required), me.
atem_set_transition_rateSet Transition RateAIdempotent
Set the transition duration/rate in frames for a specific transition type.
Args:
style (string): Which transition to set the rate for — "mix", "dip", "wipe", "dve", or "stinger"
rate (number): Duration in frames (e.g., 30 = 1 second at 30fps, 60 = 2 seconds)
me (number, optional): Mix Effect bus number (default: 0 for ME1)
Inputs: style (required), rate (required), me.
atem_set_transition_styleSet Transition StyleAIdempotent
Set the transition style (mix, dip, wipe, DVE, stinger) for auto transitions.
Args:
style (string): Transition type — "mix", "dip", "wipe", "dve", or "stinger"
me (number, optional): Mix Effect bus number (default: 0 for ME1)
Inputs: style (required), me.
atem_set_usk_on_airSet Upstream Key On AirAIdempotent
Put an upstream keyer on or off air on a specific ME bus. USKs are used for picture-in-picture, chroma key, luma key, DVE effects, etc.
Args:
me (number, optional): Mix Effect bus (default: 0 for ME1)
usk (number): Upstream keyer number (0-based, 0 = Key 1)
onAir (boolean): true to put on air, false to take off air
Inputs: usk (required), onAir (required), me.
atem_set_usk_sourcesSet Upstream Key SourcesBIdempotent
Set the fill and/or cut sources for an upstream keyer.
Args:
me (number, optional): Mix Effect bus (default: 0 for ME1)
usk (number): Upstream keyer number (0-based)
fillSource (number, optional): Input to use as fill
cutSource (number, optional): Input to use as key/cut
Inputs: usk (required), me, fillSource, cutSource.
atem_start_recordingStart RecordingAIdempotent
Start recording on the ATEM (requires USB storage connected to the switcher). Available on models with recording capability.
Inputs: no named parameters.
atem_start_streamingStart StreamingAIdempotent
Start streaming on the ATEM (requires streaming to be configured in ATEM Software Control). Available on models with streaming capability.
Inputs: no named parameters.
atem_stop_recordingStop RecordingAIdempotent
Stop recording on the ATEM.
Inputs: no named parameters.
atem_stop_streamingStop StreamingAIdempotent
Stop streaming on the ATEM.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 32 tools
Most tools have distinct purposes targeting specific ATEM functions like transitions, audio, keyers, and macros, but there is some potential overlap between atem_auto_transition and atem_preview_and_auto, as both handle auto transitions, though the latter combines preview setting. The descriptions help clarify differences, but an agent might occasionally confuse these related tools.
All tool names follow a consistent snake_case pattern with a clear 'atem_' prefix and descriptive verb_noun combinations, such as atem_set_preview, atem_get_audio_state, and atem_start_recording. This uniformity makes the tool set predictable and easy to navigate.
With 32 tools, the count is on the higher side for a video switcher server, bordering on heavy. While ATEM devices have many features, this number might overwhelm agents, though it does cover a broad range of operations. A more streamlined set could improve usability without losing functionality.
The tool set provides comprehensive coverage of the ATEM domain, including connection management, transitions, audio control, keyers, macros, recording/streaming, and status queries. It supports full CRUD-like operations for key functions, such as setting and getting states, with no apparent gaps that would hinder agent workflows.
Maintenance
Related MCP Connectors
Direct AI video, image, music and storyboard production from any MCP client.
AI video, image and audio generation with 140+ AI models from any MCP agent
AI video editor for agents and humans: timeline, captions, color, audio and generation as MCP tools.
Use AI models for chat, image, and video generation from Claude Code and other MCP hosts.
Related MCP Servers
- AlicenseAqualityDmaintenanceAllows AI assistants like Claude to directly interact with and control DaVinci Resolve through the Model Context Protocol, providing capabilities for project management, timeline manipulation, media management, and Fusion integration.1480MIT
- AlicenseBqualityDmaintenanceConnects DaVinci Resolve Studio to Claude AI via the Model Context Protocol, enabling natural language control over video editing, color grading, Fusion compositing, AI features, and more.53396MIT
- AlicenseBqualityBmaintenanceAI-powered stream and recording control for OBS Studio through the Model Context Protocol10028Apache 2.0
- AlicenseBqualityDmaintenanceEnables AI assistants to control and automate OBS Studio via natural language, covering scenes, sources, audio, recording, streaming, transitions, filters, media playback, diagnostics, and multi-step workflows over the OBS WebSocket protocol.89MIT