Usage Patterns

Create or refresh links

command -v board-webmcp-cli
skills/board-webmcp/scripts/ensure-links.sh
board-webmcp-cli -h

Read path

board-webmcp-cli nodes.list
board-webmcp-cli edges.list

For a human + AI collaborative session on the same visible board, switch the runtime first:

board-webmcp-cli bridge.session.mode.get
board-webmcp-cli bridge.session.mode.set '{"mode":"headed"}'
board-webmcp-cli bridge.open
board-webmcp-cli diagram.get
board-webmcp-cli nodes.list
board-webmcp-cli edges.list

Inspect a specific tool first when the payload matters:

board-webmcp-cli nodes.upsert -h
board-webmcp-cli edges.upsert -h
board-webmcp-cli layout.apply -h

Write path

Create or update nodes:

board-webmcp-cli nodes.upsert '{"nodes":[{"label":"Fraud Service","kind":"service","x":1440,"y":120}]}'

Create or update edges:

board-webmcp-cli edges.upsert '{"edges":[{"sourceNodeId":"gateway","targetNodeId":"orders","protocol":"grpc"}]}'

Apply deterministic layout:

board-webmcp-cli layout.apply mode=grid

Export the document:

board-webmcp-cli diagram.export format=json

For a collaborative visible session, use the same operations after switching to headed:

board-webmcp-cli nodes.upsert '{"nodes":[{"label":"Fraud Service","kind":"service","x":1440,"y":120}]}'
board-webmcp-cli edges.upsert '{"edges":[{"sourceNodeId":"gateway","targetNodeId":"orders","protocol":"grpc"}]}'
board-webmcp-cli layout.apply mode=grid
board-webmcp-cli diagram.export format=json

Local development target

skills/board-webmcp/scripts/ensure-links.sh --url http://127.0.0.1:4173

UI collaboration session

board-webmcp-cli bridge.session.mode.set '{"mode":"headed"}'
board-webmcp-cli bridge.open
board-webmcp-cli selection.get
board-webmcp-cli bridge.close