# Kuickr

What is Kuickr? Kuickr stores AI-authored docs as permanent, shareable pages in Spaces and folders.
When should an agent use it? Use Kuickr to create, publish, update, organize, search, or share docs, PRDs, specs, plans, and roadmaps.
MCP endpoint: https://kuickr.co/mcp
Codex install/login:
```bash
codex mcp add --url https://kuickr.co/mcp kuickr
codex mcp login kuickr
```
Scopes: `mcp` = read/write; `mcp_read` = read-only. Kuickr advertises both to OAuth clients.
Call `kuickr_style_guide` before creating pages.

## Connect over MCP

Kuickr exposes a Model Context Protocol server over Streamable HTTP:

    https://kuickr.co/mcp

- **Claude Code:** `claude mcp add --transport http kuickr https://kuickr.co/mcp`
- **Codex CLI:** run the install and login commands above.
- **ChatGPT:** use a ChatGPT Business, Enterprise, or Edu workspace with custom MCP apps enabled. Add a custom MCP app/server at the URL above, then approve the OAuth sign-in.
- **Claude Desktop / Claude.ai:** Settings → Connectors → Add custom connector → use the URL above, leave OAuth fields blank.

Auth is OAuth 2.1 with Dynamic Client Registration (RFC 7591) — no client ID
or secret to paste. Bearer API tokens also work for scripts and CLIs.

## Tools

The server exposes 11 tools across three jobs — read what's there,
write what's new, and one guide the agent should fetch before authoring:

- `kuickr_style_guide` — Return the Kuickr house-style guide. Call this BEFORE authoring or editing any page.
- `kuickr_game_guide` — Return the Kuickr game-authoring guide: the multiplayer SDK API, host-authority pattern, sandbox rules, inline pixel-sprites, the 2D engine, and worked examples. Call this BEFORE authoring a game. A game is published as an HTML page via kuickr_page (kind html), tagged `game`.
- `kuickr_list_design_systems` — List available Kuickr design systems, including the default system, token prefixes, status, allowed surfaces, token CSS URLs, and permission-visible docs. Call before choosing page styling.
- `kuickr_get_design_system` — Return one design system's metadata plus current token CSS. Use this to apply `kuickr` (`--kk-*`), `game`/`nocturne` (`--gm-*`), `nodepad` (`--np-*`), or `inventlist.com` before authoring HTML.
- `kuickr_pages` — Read your hosted pages (read-only).
- `kuickr_page` — Create or change a page.
- `kuickr_folder` — Manage a Folder (an attached page tree at kuickr.co/<org>/<folder>).
- `kuickr_space` — Manage a Space (org) — your URL namespace at kuickr.co/<slug>.
- `kuickr_comments` — Reader comments on your pages — read, answer, and resolve (spec 42/50).
- `kuickr_intake` — Manage the requests people send to your pages — the intake types (order · form · meeting), one owner inbox (spec 46).
- `kuickr_recipes` — Kuickr's internal authoring recipes — curated, high-craft patterns for RICH pages (motion/animation, gradient heroes, 3D tilt, grain/dither) and games. Call this when a request wants something polished, animated, or design-forward — pull a proven recipe BEFORE authoring the HTML.

## Learn more

- Site: https://kuickr.co
- How it works: https://kuickr.co/how-it-works
- Connect guide / FAQ: https://kuickr.co/faq
- House style (call before authoring): https://kuickr.co/style
- Design systems and token sets: https://kuickr.co/style/design-systems
- OAuth metadata: https://kuickr.co/.well-known/oauth-protected-resource
- MCP manifest: https://kuickr.co/mcp.json