Tools Reference
All tools operate on the live Studio editor in real-time via WebSocket. Changes appear on the canvas instantly.
The server exposes tools in four categories: Template, Node, Token, and Schema.
No pageId parameter is needed for most tools — they operate on the currently active page in Studio. Multi-page tools like list_pages and read_page let you inspect other pages.
Read the template structure and browse pages.
read_template
Read the currently loaded template from the live Studio editor. Returns the template name, category, active page, and a summary of all pages.
No parameters.
list_pages
List all pages in the template with their IDs, names, paths, and types.
No parameters.
read_page
Read a specific page’s full document tree including root node, tokens, and assets.
Read, create, update, move, and delete nodes on the live canvas. Every mutation is undo-able in Studio (Ctrl+Z).
find_nodes
Search for nodes in the current page by kind, prop name/value, or text content.
read_node
Read a single node’s full props, slots, and parent info.
update_node
Update one or more props on a node. Only pass the props you want to change — they’re merged with existing props. The canvas updates live.
add_node
Add a new node to a parent’s slot. The canvas updates live.
remove_node
Remove a node and all its children.
move_node
Move a node to a different parent, slot, or position.
view_tree
View the node tree hierarchy in a readable indented format. Great for understanding the layout.
duplicate_node
Deep-clone a node (and all children) with new IDs, inserted right after the original.
wrap_nodes
Wrap one or more sibling nodes in a new layout container.
Manage design tokens — colors, text content, translations, and other values that can be localized.
list_tokens
List tokens in the current page with optional filters.
update_token
Update an existing token’s value. Applied live in the editor.
add_token
Add a new token to the current page.
remove_token
Remove a token from the current page.
Discover available component types and their schemas. These work offline — no Studio connection needed.
list_node_kinds
List all available node kinds (component types) with descriptions and prop counts.
describe_node_kind
Get the full JSON Schema for a node kind: all props, types, slots, defaults, and editor groups.
MCP Resources
The server also exposes two resources agents can read:
Endpoints
The HTTP server exposes these endpoints:
