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
2. 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
3. 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
4. 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
5. 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