ATEM MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| ATEM_HOST | No | ATEM IP address (enables auto-connect) | |
| ATEM_PORT | No | ATEM port | 9910 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| atem_connectA | Connect to a Blackmagic ATEM video switcher on the network. Args:
Returns: Connection confirmation with ATEM model info. |
| atem_disconnectA | Disconnect from the currently connected ATEM switcher. |
| atem_get_statusA | 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. |
| atem_set_programA | Set the program (live/on-air) input on the ATEM switcher. Args:
Common input IDs: 1-20 = physical inputs, 1000 = color bars, 2001/2002 = color generators, 3010/3020 = media players, 6000 = super source, 10010 = black. |
| atem_set_previewA | Set the preview (next) input on the ATEM switcher. Args:
|
| atem_cutA | Perform a hard cut transition — instantly switches preview to program. Args:
|
| atem_auto_transitionA | Trigger an auto transition (dissolve, wipe, etc.) from preview to program using the current transition settings. Args:
|
| atem_fade_to_blackA | Toggle Fade to Black (FTB). If currently live, fades to black. If already in FTB, fades back up. Args:
|
| atem_preview_and_autoA | 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:
|
| atem_set_transition_styleA | Set the transition style (mix, dip, wipe, DVE, stinger) for auto transitions. Args:
|
| atem_set_transition_rateA | Set the transition duration/rate in frames for a specific transition type. Args:
|
| atem_set_transition_positionA | Manually set the transition position, like moving the T-bar. Useful for manual fades. Args:
|
| atem_get_transition_stateA | Get current transition settings for a Mix Effect bus including style, rates, and in-transition status. Args:
Returns: JSON with current transition style, rates per type, and whether a transition is currently in progress. |
| atem_set_aux_sourceA | Route an input source to an auxiliary output. Args:
Common uses: sending a clean feed to a recorder, routing a specific camera to a confidence monitor, etc. |
| atem_get_aux_sourceA | Get the current source routing for all auxiliary outputs. Returns: JSON object mapping each aux output to its current source input. |
| atem_set_dsk_on_airA | Put a downstream keyer on or off air. DSKs overlay graphics (logos, lower thirds, etc.) on top of the program output. Args:
|
| atem_auto_dskA | Trigger an auto transition for a downstream keyer (mix on/off air). Args:
|
| atem_set_dsk_sourcesA | Set the fill and/or key (cut) sources for a downstream keyer. Args:
|
| atem_set_usk_on_airA | 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:
|
| atem_set_usk_sourcesB | Set the fill and/or cut sources for an upstream keyer. Args:
|
| atem_macro_runB | Run an ATEM macro by index number. Args:
|
| atem_macro_stopA | Stop the currently running macro. |
| atem_macro_continueB | Continue a paused macro. |
| atem_list_macrosA | List all defined macros on the ATEM switcher. Returns: JSON array of macros with their index, name, and whether they are valid/used. |
| atem_start_recordingA | Start recording on the ATEM (requires USB storage connected to the switcher). Available on models with recording capability. |
| atem_stop_recordingA | Stop recording on the ATEM. |
| atem_start_streamingA | Start streaming on the ATEM (requires streaming to be configured in ATEM Software Control). Available on models with streaming capability. |
| atem_stop_streamingA | Stop streaming on the ATEM. |
| atem_get_recording_statusB | Get the current recording and streaming status from the ATEM. |
| atem_set_audio_mixer_inputA | 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:
|
| atem_set_audio_master_outputB | Configure the master audio output level. Args:
|
| atem_get_audio_stateA | 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. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
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.