Skip to content
Docs
Developers

MCP tools

The tools your agent gets once it is connected. The table is read from the same list the server registers its tools from, so it always matches what your agent sees.

ToolWhat it doesAuthREST equivalent
whoamiWho this connection is: the workspace, the key name and prefix, and the permissions it holds. Use it to confirm a new connection works.
API key
GET /api/v1/me
list_brandsThe brands in the workspace this key belongs to, each with its designs (id, name, status, whether it is ready to build from). Start here to find a design id.
API key
MCP only
get_design_contextThe design's continuation bundle as JSON: brief, tokens, board digest, the continuation contract (hard floor first, then the latitude level), live inventory, coherence audit and the import contract.
API key
GET /api/v1/designs/{designId}/handoff
get_repo_rules_packThe files that teach a coding agent this brand inside your repo: AGENTS.md, CLAUDE.md, a Cursor rule, DESIGN.md and the token files, each with its path and content. Merge the marked blocks, never overwrite the rest of a file.
API key
GET /api/v1/designs/{designId}/rules-pack
get_claude_design_kitThe Claude Design kit for a design: its title, file list with sizes and validation result, plus the download URL for the zip (fetch it with the same API key as a Bearer token).
API key
GET /api/v1/designs/{designId}/claude-design-kit
list_systemsList the public design systems in the BrandPilot pool (name, slug, brand color, token count, status).Older setup, stops working on 2027-01-31. Use list_brands instead.
public
GET /api/v1/systems
get_system_adoptionFull adoption manifest for a public system: tokens, components, pages, brand asset URLs and the binding design-direction block.
public
GET /api/v1/systems/{name}/adoption
get_system_tokensExport a public system's tokens in one format: globals-css, colors-ts, spacing-ts, typography-ts, tailwind-theme or brand-manifest. Calls the legacy /api/systems/export endpoint, not a v1 path - the export route has no v1 equivalent yet.
public
GET /api/systems/export/{name}
get_agent_promptMarkdown onboarding doc for a public system: the two copy-paste prompts an external AI coding agent uses to bootstrap a design package and sync it to Claude Design.Older setup, stops working on 2027-01-31. Use get_repo_rules_pack instead.
public
GET /api/v1/systems/{name}/agent-prompt
get_design_handoffThe design's continuation bundle as JSON: brief, tokens, board digest, the continuation contract (hard floor first, then the latitude level), live inventory, coherence audit and the import contract. Available mid-flow (project paused at EXTERNAL_DESIGN) and post-completion.Older setup, stops working on 2027-01-31. Use get_design_context instead.
handoff key
GET /api/v1/designs/{designId}/handoff
get_design_prompt_packThe app-authored sequential Claude Design prompt pack (markdown): anchor sheet first, then template-aware component sheets and page prompts, each embedding the latitude contract in force. Regenerated from live data on every call. Without pass it returns the v1 pack; pass=explore then pass=lock with the chosen direction return the v2 two-pass pack, and format=copy-map returns the copy map the v2 pack lists as a project file.
handoff key
GET /api/v1/designs/{designId}/prompt-pack
import_design_artifactsImport externally designed work back into DesignFlow. Rows land as DRAFT on the carrier project's Deliverables tab for human review - nothing auto-approves. Components: self-contained HTML with inline styles. Pages: standalone HTML documents. Assets: PNG (base64 or URL) with optional sourceCode.
handoff key
POST /api/v1/designs/{designId}/external-artifacts
finish_external_designValidates that components and pages were imported, optionally accepts every pending imported draft, then resumes the pipeline at the coherence audit toward Design Review. Only valid while the project is paused at EXTERNAL_DESIGN.
handoff key
POST /api/v1/designs/{designId}/finish-external

Good to know