Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
OBS_MCP_MODENoSet to compound to enable consolidated compound tools; equivalent to --compound.
OBS_READ_ONLYNoSet to true to prohibit all state modifications; equivalent to --read-only.false
OBS_MCP_MODULESNoComma-separated list of categories to load; equivalent to --categories=<list>.
OBS_WEBSOCKET_URLNoWebSocket URL for the OBS WebSocket server.ws://localhost:4455
OBS_ALLOW_LIVE_STREAMNoSet to true to permit stream start/stop without confirmation; equivalent to --allow-live-stream.false
OBS_WEBSOCKET_PASSWORDYesPassword for OBS WebSocket authentication.
OBS_PROTECT_DESTRUCTIVENoSet 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

CapabilityDetails
tools
{
  "listChanged": true
}
prompts
{
  "listChanged": true
}
resources
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
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

NameDescription
go-live-checklistPre-stream checklist and automated sanity checks before going live
recording-setupStructured setup and validation workflow for local video recording
emergency-brbImmediate emergency protocol: mute mic, switch to BRB scene, and protect recording
audio-checkComprehensive audio diagnostic and level calibration audit across all inputs

Resources

Contextual data attached and managed by the client

NameDescription
obs-state-summaryConsolidated real-time snapshot of OBS connection, active scenes, streaming/recording, outputs, and performance stats
obs-scenes-currentConsolidated snapshot of active program scene, preview scene, available scenes, and current scene items with transform/visibility states
obs-audio-mixerConsolidated audio mixer snapshot of all inputs, volume levels, mute states, sync offsets, monitor types, and track routing
obs-events-recentRecent OBS WebSocket events captured in real-time (last 100 events ring buffer: scene switches, audio changes, stream/record alerts)

TDQS

C2.8/5.0

Scored across 158 tools

Disambiguation3/5

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.

Naming Consistency5/5

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.

Tool Count2/5

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.

Completeness4/5

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.

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues