Skip to main content
Glama

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 time

Related 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 build

2. 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/node with your full Node.js path (run which node to 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_HOST

ATEM IP address (enables auto-connect)

—

ATEM_PORT

ATEM port

9910

TRANSPORT

Transport mode: stdio or http

stdio

PORT

HTTP server port (when TRANSPORT=http)

3000

BASE_URL

Public URL for OAuth endpoints (when behind a tunnel/proxy)

http://localhost:PORT

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

The 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

  1. Go to claude.ai/settings/connectors

  2. Click Add custom connector

  3. Enter your MCP URL (e.g., https://atem.yourdomain.com/mcp)

  4. Click Connect — the OAuth flow completes automatically

  5. 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

GET /.well-known/oauth-protected-resource

RFC 9728 resource metadata

GET /.well-known/oauth-authorization-server

Authorization server metadata

POST /register

Dynamic Client Registration (DCR)

GET /authorize

Authorization endpoint (auto-approves)

POST /token

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

  • cloudflared CLI installed (brew install cloudflared on macOS)

Setup

1. Authenticate and create tunnel

cloudflared login
cloudflared tunnel create atem-mcp

Note the tunnel ID (a UUID).

2. Route DNS

cloudflared tunnel route dns atem-mcp atem.yourdomain.com

3. 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:404

4. 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-mcp

Your 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:

  1. Go to Cloudflare Dashboard > select your domain

  2. On the Overview page, find "Block AI training bots" on the right sidebar

  3. 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 install

This 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 entirely

Available Tools (58 tools)

Connection

Tool

Description

atem_connect

Connect to an ATEM switcher by IP

atem_disconnect

Disconnect from the ATEM

atem_get_status

Get model, inputs, program/preview state

Switching

Tool

Description

atem_set_program

Set program (live) input

atem_set_preview

Set preview (next) input

atem_cut

Hard cut transition

atem_auto_transition

Auto transition (dissolve/wipe/etc.)

atem_fade_to_black

Toggle Fade to Black

atem_preview_and_auto

Set preview + auto transition in one call

Transitions

Tool

Description

atem_set_transition_style

Set mix, dip, wipe, DVE, or stinger

atem_set_transition_rate

Set transition duration in frames

atem_set_transition_position

Manual T-bar position (0.0–1.0)

atem_get_transition_state

Get current transition settings

Routing & Keyers

Tool

Description

atem_set_aux_source

Route input to aux output

atem_get_aux_source

Get current aux routing

atem_set_dsk_on_air

Downstream keyer on/off air

atem_auto_dsk

Auto transition for DSK

atem_set_dsk_sources

Set DSK fill and key sources

atem_set_usk_on_air

Upstream keyer on/off air

atem_set_usk_sources

Set USK fill and cut sources

Macros

Tool

Description

atem_macro_run

Run a macro by index

atem_macro_stop

Stop running macro

atem_macro_continue

Continue paused macro

atem_list_macros

List all defined macros

Recording & Streaming

Tool

Description

atem_start_recording

Start recording

atem_stop_recording

Stop recording

atem_start_streaming

Start streaming

atem_stop_streaming

Stop streaming

atem_get_recording_status

Get recording/streaming status

Super Source

Tool

Description

atem_get_supersource_state

Get all box positions, sources, art, and border settings

atem_set_supersource_box

Configure a single box (source, position, size, crop)

atem_set_supersource_layout

Set layout with presets (side-by-side, 2x2 grid, PiP, etc.)

atem_set_supersource_art

Configure art fill/cut source, foreground/background

atem_set_supersource_border

Configure border width, color, bevel, light source

atem_go_gallery

2x2 gallery grid: host + 3 guests, prioritizes active speakers via audio levels

atem_cut_to_active_speaker

Cut full-screen to whoever is currently talking (detected via audio levels)

atem_auto_switch_on

Start auto-switching: program mode (full-screen), ssrc_box mode (Super Source box), or host_ssrc mode (host full-screen + guest side-by-side)

atem_auto_switch_off

Stop auto-switching mode

atem_get_auto_switch_status

Check if auto-switch is running, see stats

atem_save_look

Save current Super Source layout as a named "look" (boxes, art, border)

atem_load_look

Load a saved look and apply it — optionally override sources for different guests

atem_list_looks

List all saved looks with descriptions and box counts

atem_delete_look

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

atem_set_audio_mixer_input

Set input gain, fader, balance, mix mode (Fairlight or Classic)

atem_set_audio_master_output

Set master output gain/fader

atem_get_audio_state

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

atem_set_fairlight_eq

Set individual EQ band (shape, frequency, gain, Q) on an input

atem_set_fairlight_eq_preset

Apply EQ preset: vocal, podcast, music, de_mud, or flat

atem_set_fairlight_compressor

Set compressor (threshold, ratio, attack, hold, release)

atem_set_fairlight_limiter

Set limiter (threshold, attack, hold, release)

atem_set_fairlight_gate

Set noise gate/expander (threshold, range, ratio, attack, release)

atem_get_fairlight_eq_state

Get full EQ + dynamics state for an input

atem_set_fairlight_master_eq

Set EQ band on master output

atem_set_fairlight_master_compressor

Set compressor on master output

atem_set_fairlight_master_limiter

Set limiter on master output

atem_set_fairlight_makeup_gain

Set makeup gain on an input

atem_reset_fairlight_dynamics

Reset compressor/limiter/gate to factory defaults

atem_reset_fairlight_eq

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 + raw http.createServer for 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.target

Resilience Features:

  • Auto-starts on boot — Service enabled with systemctl --user enable atem-mcp

  • Auto-restarts on crash — Restart=always ensures continuous operation

  • 10-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-mcp

Live 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:

  1. Verify connection — "Show me the switcher status"

  2. Test switching — "Put camera 1 on preview, then cut to it"

  3. Test transitions — "Set transition to mix at 30 frames and dissolve to camera 2"

  4. Test audio — "Show me the audio mixer state"

  5. Test recording/streaming — "Start recording" → verify → "Stop recording"

  6. Test Super Source (if using) — "Set up a side-by-side with cameras 1 and 2"

  7. Set your show defaults — transition style, rate, audio levels, EQ presets

Tips for Live Production

  • Set ATEM_HOST in your environment so the server auto-connects on startup — no need to manually connect each time

  • Use 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_auto call

  • Keep 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 (run which node)

  • Check logs: ~/Library/Logs/Claude/mcp*.log

  • Restart 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_URL matches your public tunnel URL exactly

  • Test 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-stream but some clients send Accept: */*

  • 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_status to verify connection

Credits

License

MIT

Available Tools

32 tools
atem_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 SwitcherA
Idempotent

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 ATEMA
Idempotent

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 StateA
Read-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 SourcesA
Read-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 StatusB
Read-onlyIdempotent

Get the current recording and streaming status from the ATEM.

Inputs: no named parameters.

atem_get_statusGet ATEM StatusA
Read-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 StateA
Read-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 MacrosA
Read-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 MacroA
Idempotent

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 OutputB
Idempotent

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 PropertiesA
Idempotent

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 SourceA
Idempotent

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 AirA
Idempotent

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 SourcesA
Idempotent

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 InputA
Idempotent

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 InputA
Idempotent

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)A
Idempotent

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 RateA
Idempotent

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 StyleA
Idempotent

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 AirA
Idempotent

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 SourcesB
Idempotent

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 RecordingA
Idempotent

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 StreamingA
Idempotent

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 RecordingA
Idempotent

Stop recording on the ATEM.

Inputs: no named parameters.

atem_stop_streamingStop StreamingA
Idempotent

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

    A3.9/5.0

    Scored across 32 tools

    Disambiguation4/5

    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.

    Naming Consistency5/5

    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.

    Tool Count3/5

    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.

    Completeness5/5

    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

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Allows 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.
      14
      80
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      Enables 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.
      89
      MIT