list_sources
Retrieve all scene items from the current or specified scene in OBS Studio to manage and organize your streaming setup.
Instructions
List all sources (scene items) in a scene. Defaults to the current scene.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| scene_name | No | Scene name. Omit to use the current program scene. |
Implementation Reference
- obs-mcp-server.js:426-443 (handler)The handler logic for the 'list_sources' tool, which fetches scene items for a given or current scene.
case "list_sources": { let sceneName = args.scene_name; if (!sceneName) { const { currentProgramSceneName } = await obs.call("GetSceneList"); sceneName = currentProgramSceneName; } const { sceneItems } = await obs.call("GetSceneItemList", { sceneName }); return ok({ scene: sceneName, sources: sceneItems.map((item) => ({ id: item.sceneItemId, name: item.sourceName, type: item.sourceType, kind: item.inputKind ?? null, visible: item.sceneItemEnabled, })), }); } - obs-mcp-server.js:104-116 (registration)The registration/definition of the 'list_sources' tool in the TOOLS array.
name: "list_sources", description: "List all sources (scene items) in a scene. Defaults to the current scene.", inputSchema: { type: "object", properties: { scene_name: { type: "string", description: "Scene name. Omit to use the current program scene.", }, }, }, },