Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
OBS_MCP_HOSTNoHost for the OBS WebSocket server127.0.0.1
OBS_MCP_PORTNoPort for the OBS WebSocket server4455
VAULTPROXY_URLNoURL of the vaultproxy service (required if OBS_MCP_SECRETS=vaultproxy)
OBS_MCP_SECRETSNoBackend for secret storage: 'env', 'file', or 'vaultproxy' (default: 'env')
OBS_MCP_PASSWORDNoPassword for the OBS WebSocket server (required if using env backend)

Capabilities

Features and capabilities supported by this server

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
list_scenesA

List scenes and the current program/preview scene.

switch_sceneC

Switch the program output to a scene (immediate cut on program).

set_preview_sceneC

Set the preview scene (studio mode).

trigger_transitionC

Trigger the studio-mode transition (preview → program).

set_studio_modeC

Enable or disable studio mode.

list_scene_itemsB

List the items (sources) inside a scene with visibility state.

set_scene_item_visibilityC

Show or hide a scene item (item_id from list_scene_items).

list_inputsA

List all inputs (sources) with their kinds.

get_audio_levelsA

List audio inputs with mute state and volume (dB).

set_muteC

Mute or unmute an audio input.

set_volumeC

Set an audio input's volume in dB (0 = unity, negative = quieter).

update_text_sourceB

Set the text of a Text (GDI+/FreeType) source — e.g. an on-stream overlay line like a giveaway question or now-playing label.

screenshot_sourceC

Save a PNG screenshot of a source (or scene) to a local file.

media_controlC

Control a media source. action: play|pause|restart|stop|next|previous.

list_source_filtersC

List filters on a source with enabled state.

set_filter_enabledC

Enable or disable a named filter on a source.

get_scene_item_transformB

Get a scene item's position, scale, and crop.

set_scene_item_transformA

Move/scale a scene item (item_id from list_scene_items). Only supplied fields change — e.g. scale_x/scale_y 0.5 halves a facecam.

watch_healthA

Sample OBS stats for up to 60 seconds and report a stream-health verdict: dropped-frame %, GPU misses, CPU pressure.

stream_statusA

Streaming state: live, duration, bytes, dropped frames.

start_streamC

Go live: start streaming to the configured service.

stop_streamC

End the live stream.

record_statusB

Recording state: active, paused, duration, output path.

start_recordC

Start recording.

stop_recordC

Stop recording; returns the saved file path.

pause_recordC

Pause (true) or resume (false) the recording.

save_replayB

Save the replay buffer (must be running). Returns the clip path.

set_replay_bufferC

Start (true) or stop (false) the replay buffer.

set_virtual_camC

Start (true) or stop (false) the virtual camera.

get_statsA

OBS performance stats: CPU, memory, FPS, frame drops, disk space.

list_profilesA

List OBS profiles and the current one.

switch_profileC

Switch OBS profile (stream settings bundle).

list_scene_collectionsB

List scene collections and the current one.

switch_scene_collectionC

Switch scene collection (full scene layout bundle).

trigger_hotkeyB

Trigger an OBS hotkey by name (see get_hotkey_list in OBS docs).

health_checkA

Verify the OBS websocket connection and report versions.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/aaronckj/obs-studio-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server