API reference

The DreamUI connector exposes 29 MCP tools over stdio. Harnesses discover them at runtime with tools/list and call them with tools/call.

Discovery

Call MCP tools/list to get every tool with its current input schema. The schema returned at runtime is authoritative — tool names, accepted agent values, and optional fields come from it.

Core tools

Core DreamUI MCP tools
Tool	Purpose
`uicopilot_auth`	Sign the host in with device login. Actions: status, start, poll.
`uicopilot_agent_run`	Generate or edit a website or interface from a prompt.
`uicopilot_sessions_list`	List the managed DreamUI sessions available to the signed-in user.
`uicopilot_commands`	Inspect a dispatched command and its current status.
`uicopilot_session_snapshot`	Fetch the latest state of a session.

Arguments and examples for generation and sessions are in MCP adapter; auth actions are in Device login.

HTTP endpoints

Base URL https://dreamui.com. The adapter calls these for sign-in; most integrations never need to call them directly.

Device-login HTTP endpoints
Endpoint	Use
`POST /api/cli/auth/start`	Begin device login. Returns deviceCode, userCode, expiresIn, loginUrl.
`POST /api/cli/auth/poll`	Exchange a device code. Returns pending, or claimed with a token.
`GET /api/cli/auth/status`	Check a CLI token. Returns { ok: true } or 401.