Setup Guide

Connect your AI to the Portal in 2 minutes

Step 1: Open the Portal

Open portal.rootz.global in your browser. A wallet is created automatically — no sign-up needed. You'll see your unique Portal ID and MCP connection URL.

Step 2: Connect Your AI

Claude Code (VS Code / CLI)

1

Copy the MCP line from the Portal welcome screen, or use:

click to copyclaude mcp add --transport http rootz-portal https://portal.rootz.global/mcp/YOUR_WALLET_ID
2

Restart Claude Code (Ctrl+Shift+P → "Claude Code: Restart")

3

Tell Claude: "Read https://portal.rootz.global/spec.md then draw something on the Portal"

Replace YOUR_WALLET_ID with the ID shown on your Portal welcome screen.

ChatGPT (Developer Mode)

1

Go to ChatGPT Settings → Developer → MCP Servers → Add

2

Enter the MCP URL from your Portal welcome screen:

click to copyhttps://portal.rootz.global/mcp/YOUR_WALLET_ID
3

Transport: HTTP. Auth: None.

4

Upload the spec file to teach ChatGPT the tools:

click to copyRead this spec to learn the Portal tools: https://portal.rootz.global/spec.md

ChatGPT may need to be reconnected if tools don't appear. Remove and re-add the MCP app.

Cursor / Windsurf / Other MCP AI

1

Add an HTTP MCP server in your AI's settings:

click to copyhttps://portal.rootz.global/mcp/YOUR_WALLET_ID
2

Transport: HTTP Streamable. No authentication.

3

The AI should discover 12 tools starting with stage_.

Step 3: Start Drawing

Once connected, ask your AI:

click to copyDraw a SWOT analysis for a startup that builds AI visual interfaces

Or try a presentation:

click to copyRead https://portal.rootz.global/presentations/portal-pitch.md and present it on the Portal

Keyboard Shortcuts

Alt + Left — Back (previous scene)
Alt + Right — Forward
Ctrl + E — Export session as JSON
Space — Pause/resume (in local mode)

Troubleshooting

Portal says "Waiting for AI" but I connected the MCP

Refresh the Portal page. The WebSocket may have disconnected during setup. Once you see "connected" in the top-right corner, the AI can render.

ChatGPT says "Resource not found" when rendering

ChatGPT's MCP bridge caches tools on first connect. Remove and re-add the MCP app in Developer settings to force a refresh.

Colors don't render correctly

Use CSS hex format: "#44dd77". The renderer also accepts "0x44dd77" and integers. Avoid rgb() — not supported.

Narration doesn't play

Some browsers block TTS until user interaction. Click anywhere on the Portal page first, then retry.

Scene is stuck / not advancing

The queue may be blocked by stale narration. Refresh the page — it auto-reconnects and the queue resets.

Can two AIs draw on the same screen?

Yes. Multiple AIs can connect to the same wallet session. They share the same queue. Last render wins, or use stage_add to build collaboratively.

Resources

Complete Spec — full reference with every element type, examples, and patterns

AI Skill File — quick reference for AI tools

Whitepaper — architecture, vision, and roadmap

AI Discovery — machine-readable service description

GitHub — source code