Board WebMCP

Use this skill to operate the native board demo through @webmcp-bridge/local-mcp.

Prerequisites

• uxc is installed and available in PATH.
• npx is installed and available in PATH.
• Network access to https://board.holon.run.
• On a fresh machine, or under an isolated HOME, install Playwright browsers first with npx playwright install.
• For local board development, point the setup script at http://127.0.0.1:4173.

Core Workflow

1. Ensure the fixed board link exists:

- command -v board-webmcp-cli - if missing or pointed at the wrong URL, run skills/board-webmcp/scripts/ensure-links.sh

1. Inspect the bridge and tool schema before calling tools:

- board-webmcp-cli -h - board-webmcp-cli nodes.list -h - board-webmcp-cli nodes.upsert -h

1. Read current board state:

- non-collaborative automation: board-webmcp-cli nodes.list, board-webmcp-cli edges.list - collaborative visible session: - board-webmcp-cli bridge.session.mode.set '{"mode":"headed"}' - board-webmcp-cli bridge.open - board-webmcp-cli nodes.list - board-webmcp-cli edges.list

1. Apply updates with structured inputs:

- board-webmcp-cli diagram.export format=json - collaborative visible session should keep the same runtime in headed - board-webmcp-cli nodes.upsert '{"nodes":[{"label":"Fraud Service","kind":"service"}]}' - board-webmcp-cli edges.upsert '{"edges":[{"sourceNodeId":"gateway","targetNodeId":"orders","protocol":"grpc"}]}' - board-webmcp-cli layout.apply mode=layered - board-webmcp-cli diagram.export format=json

1. When a human is editing or reviewing the same board live:

- check current state with board-webmcp-cli bridge.session.status - if needed, switch to headed with board-webmcp-cli bridge.session.mode.set '{"mode":"headed"}' - board-webmcp-cli bridge.open - keep all reads and writes on board-webmcp-cli for that same collaborative session - board-webmcp-cli selection.get - board-webmcp-cli bridge.close - if the human closed the board window manually, the headed owner session has ended; run board-webmcp-cli bridge.open again to start a new headed session on the same profile

Default Target

The default public target is:

https://board.holon.run

The default board profile path is:

~/.uxc/webmcp-profile/board

Use the helper script to refresh the link for the public deployment:

skills/board-webmcp/scripts/ensure-links.sh

Use the helper script to point the link at local development instead:

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

If the bridge fails to start on a fresh machine or inside an isolated HOME, install Playwright browsers in that environment first:

npx playwright install

Guardrails

• board.holon.run is a shared demo. Writes are visible on the board surface and persisted in browser storage for that profile.
• Prefer explicit bridge.session.mode.set over relying on a new launcher invocation to change runtime mode.
• Before collaborative editing, confirm the runtime is actually headed.
• If the human closes that window manually, the headed owner session ends. The next board-webmcp-cli bridge.open starts a new headed session on the same profile.
• Keep the board profile isolated from other sites.
• Use JSON output for automation. Do not depend on human-formatted text output.

References

• Common command patterns:

- references/usage-patterns.md

• Link creation helper:

- scripts/ensure-links.sh