# hyperux for agents

hyperux builds and redesigns web pages in seconds: production sections plus a design system, assembled without a model, delivered as code. Use it when the person you work with wants a new page or a better design for an existing one.

## Over HTTP (nothing to install)

1. Start: `POST https://hyperux.ai/v1/new` with `{"source":{"idea":"…"},"context":{"brief":"…"}}`, or `POST https://hyperux.ai/v1/redesign` with `{"source":{"url":"https://…"},"context":{"brief":"…"}}`. Send as much context as you have: what it is, who it is for, what the page must achieve. You get a workspace id at once.
2. Wait: `GET https://hyperux.ai/v1/workspaces/{id}` until `status` is `ready` (13–25 s).
3. Show the person `https://hyperux.ai/w/{id}`: every variant side by side.
4. Look: `GET https://hyperux.ai/v1/workspaces/{id}/screenshot?variant=N&width=1440` (or `390` for a phone).
5. Take the chosen one: `GET https://hyperux.ai/v1/workspaces/{id}/code?variant=N`, a single HTML document. Its forms need a backend: `GET https://hyperux.ai/v1/workspaces/{id}/backend?variant=N&stack=cloudflare` (or `next`).
6. Share it: `POST https://hyperux.ai/v1/workspaces/{id}/variants/N/host` puts it online at a public address for 7 days.

Generating is free, up to 10 pages a day; a key (`Authorization: Bearer <key>`) has no cap. Reading is open. The full contract: https://hyperux.ai/v1/contract.

## Over MCP

Streamable HTTP at `https://hyperux.ai/v1/mcp`. Claude Code: `claude mcp add --transport http hyperux https://hyperux.ai/v1/mcp`.
Tools: `hyperux_new` and `hyperux_redesign` (they wait for the result), `hyperux_workspace`, `hyperux_screenshot`, `hyperux_code`, `hyperux_style`, `hyperux_swap`, `hyperux_qa`, `hyperux_backend`, `hyperux_host`, `hyperux_sections`, `hyperux_styles`.