@statelyai/mcp 0.10.0 → 0.11.0

package/README.md

@@ -133,8 +133,9 @@ Complete Stately sign-in when the client connects.
 <!-- shared machine input schemas from src/server.ts -->
 
 Most tools accept a machine config object or a source document. Conversion
-accepts XState, SCXML, XGraph, Mermaid, and D2 sources; target formats exclude
-Mermaid. Validation also supports JSON and YAML.
+accepts XState, SCXML, XGraph, legacy Stately DigraphDef, Mermaid, and D2
+sources; target formats exclude DigraphDef and Mermaid. Validation also supports
+JSON and YAML.
 
 ## `validate_machine`
 
@@ -168,9 +169,9 @@ createMachine({
 
 <!-- convert_machine registration from src/server.ts and convert response contract -->
 
-Converts XState, SCXML, XGraph, Mermaid, or D2 input to XState, SCXML, XGraph,
-or D2. The response contains the target `format`, converted `content`, and any
-`warnings`.
+Converts XState, SCXML, XGraph, legacy Stately DigraphDef, Mermaid, or D2 input
+to XState, SCXML, XGraph, or D2. The response contains the target `format`,
+converted `content`, and any `warnings`.
 
 <details>
 <summary>Summary: convert XState to SCXML</summary>
@@ -444,8 +445,8 @@ breadcrumbs, select/pan/structural-simulation controls, selection utilities,
 zoom, viewport recovery, keyboard shortcuts, and a host-mediated link to the
 same graph in Stately. It starts in pan mode; AI controls remain hidden.
 Pass XState source text (the default for strings), a JSON machine config, SCXML,
-XGraph, Mermaid, or D2; the server converts it once to canonical XGraph before
-rendering the app and PNG fallbacks.
+XGraph, legacy Stately DigraphDef, Mermaid, or D2; the server converts it once
+to canonical XGraph before rendering the app and PNG fallbacks.
 Other image-capable clients receive one PNG fallback per parent node. Structured
 content uses a required `schemaVersion: "2.0"` envelope with a canonical XGraph
 JSON string in `interactive.graphJson`. Every V2 field has a concrete JSON
@@ -467,6 +468,10 @@ Each returned image uses the MCP `ImageContent` shape:
 { type: 'image', data: pngBase64, mimeType: 'image/png' }
 ```
 
+Use `visualize_stately_machine({ machineId, direction?, parentNodeIds? })` to
+fetch and render a hosted machine in one call. It prefers the public `graph`,
+then an XGraph-shaped stored `definition`, then legacy DigraphDef compatibility.
+
 <details>
 <summary>Summary: visualize a machine</summary>
 
@@ -517,7 +522,7 @@ export const player = createMachine({
 
 ## Hosted resource tools
 
-<!-- resource tool registrations from src/resourceTools.ts -->
+<!-- hosted resource tool registrations from src/resourceTools.ts and src/server.ts -->
 
 These tools read hosted Stately projects and machines through the server-owned
 `/api/v1` resource contract. They are separate from the workspace tools
@@ -529,6 +534,7 @@ These tools read hosted Stately projects and machines through the server-owned
 | `get_stately_project`           | One project, with its current project version id and machine ids. |
 | `list_stately_project_machines` | The machines in a project.                                        |
 | `get_stately_machine`           | One machine, with its definition.                                 |
+| `visualize_stately_machine`     | Fetch and visualize one hosted machine in one call.                |
 
 Inputs take a `projectId` or `machineId`, never a project version id.