get_scene

Fetch one scene by id. The result is null if the scene does not exist or falls outside the caller’s read scope. Dispatches to the get_scene internal service method.

Parameters

Name	Type	Required	Default	Description
`scene_id`	string	Yes	—	The scene UUID to fetch.

Returns

{ "scene": null }

Returned as the structuredContent payload. When the scene is visible, scene is the full scene object; otherwise it is null.

Example

Request:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_scene",
    "arguments": { "scene_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7" }
  }
}

Response:

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      { "type": "text", "text": "{\"scene\":null}" }
    ],
    "structuredContent": { "scene": null },
    "isError": false
  }
}

Annotations

The tool’s MCP behaviour hints, as emitted in tools/list (advisory display metadata — see the annotations contract):

`readOnlyHint`	`destructiveHint`	`idempotentHint`	`openWorldHint`
`true`	`false`	`true`	`false`

A pure read — writes nothing.

list_scenes to enumerate visible scenes.

Overview

Tools

Parameters

Returns

Example

Annotations

​Parameters

​Returns

​Example

​Annotations

​Related

Parameters

Returns

Example

Annotations

Related