OBS MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| OBS_MCP_MODE | No | Set to compound to enable consolidated compound tools; equivalent to --compound. | |
| OBS_READ_ONLY | No | Set to true to prohibit all state modifications; equivalent to --read-only. | false |
| OBS_MCP_MODULES | No | Comma-separated list of categories to load; equivalent to --categories=<list>. | |
| OBS_WEBSOCKET_URL | No | WebSocket URL for the OBS WebSocket server. | ws://localhost:4455 |
| OBS_ALLOW_LIVE_STREAM | No | Set to true to permit stream start/stop without confirmation; equivalent to --allow-live-stream. | false |
| OBS_WEBSOCKET_PASSWORD | Yes | Password for OBS WebSocket authentication. | |
| OBS_PROTECT_DESTRUCTIVE | No | Set to true to block destructive/stream actions unless confirm: true is passed; equivalent to --protect-destructive. | false |
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
} |
| prompts | {
"listChanged": true
} |
| resources | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| obs-get-statusA | Get the current status of the OBS MCP server and OBS connection |
| obs-get-versionB | Get OBS Studio version information |
| obs-test-connectionB | Test the connection to OBS WebSocket |
| obs-get-statsB | Gets statistics about OBS, obs-websocket, and the current session |
| obs-broadcast-custom-eventC | Broadcasts a CustomEvent to all WebSocket clients |
| obs-call-vendor-requestC | Call a request registered to a vendor |
| obs-get-hotkey-listB | Gets an array of all hotkey names in OBS |
| obs-trigger-hotkey-by-nameC | Triggers a hotkey using its name |
| obs-trigger-hotkey-by-key-sequenceC | Triggers a hotkey using a sequence of keys |
| obs-execute-batchC | Executes multiple OBS WebSocket requests atomically as a batch (OpCode 8 RequestBatch) |
| obs-get-recent-eventsC | Get recent OBS events captured in the real-time circular ring buffer |
| obs-sleepB | Sleeps for a time duration or number of frames |
| obs-get-scene-listB | Get a list of scenes in OBS |
| obs-get-current-sceneB | Get the current active scene in OBS |
| obs-set-current-sceneC | Set the current active scene in OBS |
| obs-get-preview-sceneA | Get the current preview scene in OBS Studio Mode |
| obs-set-preview-sceneB | Set the current preview scene in OBS Studio Mode |
| obs-create-sceneC | Create a new scene in OBS |
| obs-remove-sceneC | Remove a scene from OBS |
| obs-trigger-studio-transitionB | Trigger a transition from preview to program scene in Studio Mode |
| obs-get-group-listB | Gets an array of all groups in OBS |
| obs-set-scene-nameB | Sets the name of a scene (rename) |
| obs-get-scene-transition-overrideC | Gets the scene transition overridden for a scene |
| obs-set-scene-transition-overrideC | Sets the scene transition overridden for a scene |
| obs-get-source-activeB | Gets the active and show state of a source |
| obs-get-source-screenshotB | Gets a screenshot of a source or current scene as native MCP multimodal ImageContent for vision models |
| obs-save-source-screenshotB | Saves a screenshot of a source to the filesystem |
| obs-get-source-private-settingsC | Gets the private settings of a source |
| obs-set-source-private-settingsC | Sets the private settings of a source |
| obs-get-scene-itemsC | Get a list of all scene items in a scene |
| obs-create-scene-itemC | Create a scene item for a source in a scene |
| obs-remove-scene-itemC | Remove a scene item from a scene |
| obs-set-scene-item-enabledC | Show or hide a scene item |
| obs-get-scene-item-transformC | Get the position, rotation, scale, or crop of a scene item |
| obs-set-scene-item-transformC | Set the position, rotation, scale, or crop of a scene item |
| obs-get-scene-item-idB | Get the ID of a scene item by its source name |
| obs-get-group-scene-itemsC | Get a list of all scene items in a group |
| obs-get-scene-item-sourceC | Gets the source associated with a scene item |
| obs-duplicate-scene-itemC | Duplicates a scene item, copying all transform and crop info |
| obs-get-scene-item-enabledB | Gets the enable/visibility state of a scene item |
| obs-get-scene-item-lockedC | Gets the lock state of a scene item |
| obs-set-scene-item-lockedC | Sets the lock state of a scene item |
| obs-get-scene-item-indexB | Gets the index position of a scene item in a scene (0 is bottom of the source list) |
| obs-set-scene-item-indexA | Sets the index position of a scene item in a scene (0 is bottom of the source list) |
| obs-get-scene-item-blend-modeC | Gets the blend mode of a scene item |
| obs-set-scene-item-blend-modeC | Sets the blend mode of a scene item (OBS_BLEND_NORMAL, OBS_BLEND_ADDITIVE, OBS_BLEND_SUBTRACT, OBS_BLEND_SCREEN, OBS_BLEND_MULTIPLY, OBS_BLEND_LIGHTEN, OBS_BLEND_DARKEN) |
| obs-get-scene-item-private-settingsB | Gets the private settings of a scene item |
| obs-set-scene-item-private-settingsC | Sets the private settings of a scene item |
| obs-get-stream-statusB | Get the current streaming status |
| obs-start-streamC | Start streaming in OBS |
| obs-stop-streamC | Stop streaming in OBS |
| obs-toggle-streamC | Toggle the streaming state in OBS |
| obs-send-stream-captionC | Sends CEA-608 caption text over the stream output |
| obs-get-transition-listB | Get a list of available transitions in OBS |
| obs-get-current-transitionB | Get the name of the currently active transition |
| obs-set-current-transitionC | Set the current transition in OBS |
| obs-get-transition-durationA | Get the duration of the current transition in milliseconds |
| obs-set-transition-durationC | Set the duration of the current transition in milliseconds |
| obs-get-transition-kindB | Get the kind/type of the current transition |
| obs-set-transition-settingsC | Set the settings of the current transition |
| obs-get-transition-settingsB | Get the settings of the current transition |
| obs-trigger-transitionB | Trigger a scene transition in OBS (Studio Mode must be enabled) |
| obs-get-transition-kind-listB | Gets an array of all available transition kinds in OBS |
| obs-get-transition-cursorA | Gets the cursor position of the current scene transition (0.0 to 1.0, 1.0 when inactive) |
| obs-set-tbar-positionC | Sets the position of the TBar |
| obs-get-persistent-dataC | Gets the value of a slot from the selected persistent data realm |
| obs-set-persistent-dataC | Sets the value of a slot from the selected persistent data realm |
| obs-get-scene-collection-listB | Gets an array of all scene collections |
| obs-set-current-scene-collectionC | Switches to a scene collection |
| obs-create-scene-collectionC | Creates a new scene collection, switching to it in the process |
| obs-get-profile-listB | Gets an array of all profiles |
| obs-set-current-profileC | Switches to a profile |
| obs-create-profileC | Creates a new profile, switching to it in the process |
| obs-remove-profileB | Removes a profile. If the current profile is chosen, it will change to a different profile first |
| obs-get-profile-parameterB | Gets a parameter from the current profile's configuration |
| obs-set-profile-parameterC | Sets the value of a parameter in the current profile's configuration |
| obs-get-video-settingsB | Gets the current video settings |
| obs-set-video-settingsC | Sets the current video settings |
| obs-get-stream-service-settingsB | Gets the current stream service settings |
| obs-set-stream-service-settingsC | Sets the current stream service settings |
| obs-get-record-directoryB | Gets the current directory that the record output is set to |
| obs-set-record-directoryC | Sets the current directory that the record output writes files to |
| obs-get-filter-kind-listB | Gets an array of all available source filter kinds |
| obs-get-source-filter-listB | Gets an array of all of a source's filters |
| obs-get-filter-default-settingsC | Gets the default settings for a filter kind |
| obs-create-source-filterC | Creates a new filter, adding it to the specified source |
| obs-remove-source-filterC | Removes a filter from a source |
| obs-set-source-filter-nameC | Sets the name of a source filter (rename) |
| obs-get-source-filterC | Gets the info for a specific source filter |
| obs-set-source-filter-indexC | Sets the index position of a filter on a source |
| obs-set-source-filter-settingsC | Sets the settings of a source filter |
| obs-set-source-filter-enabledC | Sets the enable state of a source filter |
| obs-get-input-listC | Gets an array of all inputs in OBS |
| obs-get-input-kind-listB | Gets an array of all available input kinds in OBS |
| obs-get-special-inputsB | Gets the names of all special inputs |
| obs-create-inputC | Creates a new input, adding it as a scene item to the specified scene |
| obs-remove-inputC | Removes an existing input |
| obs-set-input-nameC | Sets the name of an input (rename) |
| obs-get-input-default-settingsC | Gets the default settings for an input kind |
| obs-get-input-settingsC | Gets the settings of an input |
| obs-set-input-settingsC | Sets the settings of an input |
| obs-get-input-muteB | Gets the audio mute state of an input |
| obs-set-input-muteC | Sets the audio mute state of an input |
| obs-toggle-input-muteC | Toggles the audio mute state of an input |
| obs-get-input-volumeC | Gets the current volume setting of an input |
| obs-set-input-volumeC | Sets the volume setting of an input |
| obs-get-input-audio-balanceC | Gets the audio balance of an input |
| obs-set-input-audio-balanceC | Sets the audio balance of an input |
| obs-get-input-audio-sync-offsetC | Gets the audio sync offset of an input |
| obs-set-input-audio-sync-offsetC | Sets the audio sync offset of an input |
| obs-get-input-audio-monitor-typeB | Gets the audio monitor type of an input |
| obs-set-input-audio-monitor-typeC | Sets the audio monitor type of an input |
| obs-get-input-audio-tracksB | Gets the enable state of all audio tracks of an input |
| obs-set-input-audio-tracksB | Sets the enable state of audio tracks of an input |
| obs-get-input-deinterlace-modeA | Gets the deinterlace mode of an input (restricted to async inputs only) |
| obs-set-input-deinterlace-modeB | Sets the deinterlace mode of an input (restricted to async inputs only) |
| obs-get-input-deinterlace-field-orderA | Gets the deinterlace field order of an input (restricted to async inputs only) |
| obs-set-input-deinterlace-field-orderB | Sets the deinterlace field order of an input (restricted to async inputs only) |
| obs-get-input-properties-list-property-itemsC | Gets the items of a list property from an input's properties (e.g. display capture available displays) |
| obs-press-input-properties-buttonC | Presses a button in the properties of an input (e.g. 'refreshnocache' for browser sources) |
| obs-get-media-input-statusC | Gets the status of a media input |
| obs-set-media-input-cursorC | Sets the cursor position of a media input |
| obs-offset-media-input-cursorC | Offsets the current cursor position of a media input |
| obs-trigger-media-input-actionC | Triggers an action on a media input |
| obs-get-virtual-cam-statusB | Gets the status of the virtualcam output |
| obs-toggle-virtual-camB | Toggles the state of the virtualcam output |
| obs-start-virtual-camC | Starts the virtualcam output |
| obs-stop-virtual-camB | Stops the virtualcam output |
| obs-get-replay-buffer-statusB | Gets the status of the replay buffer output |
| obs-toggle-replay-bufferB | Toggles the state of the replay buffer output |
| obs-start-replay-bufferC | Starts the replay buffer output |
| obs-stop-replay-bufferB | Stops the replay buffer output |
| obs-save-replay-bufferB | Saves the contents of the replay buffer output |
| obs-get-last-replay-buffer-replayB | Gets the filename of the last replay buffer save file |
| obs-get-output-listB | Gets the list of available outputs |
| obs-get-output-statusC | Gets the status of an output |
| obs-toggle-outputC | Toggles the status of an output |
| obs-start-outputD | Starts an output |
| obs-stop-outputC | Stops an output |
| obs-get-output-settingsC | Gets the settings of an output |
| obs-set-output-settingsC | Sets the settings of an output |
| obs-get-record-statusC | Gets the status of the record output |
| obs-toggle-recordC | Toggles the status of the record output |
| obs-start-recordD | Starts the record output |
| obs-stop-recordC | Stops the record output |
| obs-toggle-record-pauseB | Toggles pause on the record output |
| obs-pause-recordC | Pauses the record output |
| obs-resume-recordC | Resumes the record output |
| obs-split-record-fileB | Splits the current file being recorded into a new file |
| obs-create-record-chapterB | Adds a new chapter marker to the file currently being recorded |
| obs-get-studio-modeB | Gets whether studio mode is enabled |
| obs-set-studio-modeC | Enables or disables studio mode |
| obs-open-input-propertiesC | Opens the properties dialog of an input |
| obs-open-input-filtersC | Opens the filters dialog of an input |
| obs-open-input-interactC | Opens the interact dialog of an input |
| obs-get-monitor-listB | Gets a list of connected monitors and information about them |
| obs-open-video-mix-projectorC | Opens a projector for a specific output video mix |
| obs-open-source-projectorC | Opens a projector for a source |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| go-live-checklist | Pre-stream checklist and automated sanity checks before going live |
| recording-setup | Structured setup and validation workflow for local video recording |
| emergency-brb | Immediate emergency protocol: mute mic, switch to BRB scene, and protect recording |
| audio-check | Comprehensive audio diagnostic and level calibration audit across all inputs |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| obs-state-summary | Consolidated real-time snapshot of OBS connection, active scenes, streaming/recording, outputs, and performance stats |
| obs-scenes-current | Consolidated snapshot of active program scene, preview scene, available scenes, and current scene items with transform/visibility states |
| obs-audio-mixer | Consolidated audio mixer snapshot of all inputs, volume levels, mute states, sync offsets, monitor types, and track routing |
| obs-events-recent | Recent OBS WebSocket events captured in real-time (last 100 events ring buffer: scene switches, audio changes, stream/record alerts) |
TDQS
Scored across 158 tools
Most tools map one-to-one onto distinct obs-websocket requests with explicit resource+action names, so the vast majority are easy to tell apart. However there are real overlaps: obs-trigger-transition vs obs-trigger-studio-transition (both described as studio-mode transitions), obs-start-stream/stop-stream vs obs-start-output/stop-output, obs-toggle-record vs start/stop/pause-record, and state getters like obs-get-source-active vs obs-get-scene-item-enabled. At 158 tools these redundancies make misselection a genuine risk.
Nearly every tool follows the same obs-{verb}-{noun} kebab-case pattern (get-/set-/toggle-/start-/stop-/create-/remove-/trigger-). Only trivial outliers like obs-sleep and obs-open-input-properties deviate, and they remain readable and unambiguous.
158 tools is an order of magnitude beyond a comfortable agent-facing surface, and mirrors the full obs-websocket protocol rather than curating what an agent actually needs. While nearly every tool corresponds to a real API call, the resulting selection cost and near-duplicate convenience wrappers (per-output vs per-stream vs generic output tools) make the set unwieldy.
Coverage is exceptionally broad — scenes, scene items, inputs, filters, transitions, outputs, profiles, scene collections, media control, and hotkeys all have create/read/update/delete coverage. A few gaps remain, such as no get/set-input-properties or source settings (only private settings), and no remove-scene-collection, but these are minor and workable.