mcp
Tools & resources reference
What the server exposes to your agent. Each tool returns a focused slice so the agent pulls exactly what it needs.
Diagnostics
Free — no credits charged.
| Tool | Purpose | Credits |
|---|---|---|
| health | Server status, version, and uptime. No auth required. | free |
| whoami | Your user, org, project scope, and credit balance. | free |
Captures
Org-scoped.
| Tool | Purpose | Credits |
|---|---|---|
| list_captures | Paginated list of your captures, newest first. | 1 |
| search_captures | Keyword search across captures. | 1 |
| get_capture | Full payload + signed screenshot URLs for one capture. | 1 |
| get_palette | Just the palette — page colors or eyedropper picks. | 1 |
| get_html | Just the HTML — full page, element outerHTML, or composite. | 1 |
| get_animation | Just the motion data — transitions, keyframes, library hints. | 1 |
| get_media | Just the media inventory — videos, images, backgrounds, carousels. | 1 |
| get_structure | The Layer-Explorer structure map — nodes, rects, selectors, components. | 1 |
Brand briefs & references
Project-scoped.
| Tool | Purpose | Credits |
|---|---|---|
| list_briefs | Every brief on a project — id, type, name, status. | 1 |
| get_brand_brief | Full published brief — positioning, values, voice, audience, design intent. | 1 |
| get_voice | Voice slice — tone, do/don't say, example phrases. | 1 |
| get_audience | Primary + secondary segments, needs, channels. | 1 |
| get_design_intent | Descriptors, anti-descriptors, inspiration summary. | 1 |
| get_brand_tokens | Colors, fonts, radius, and shadow scales. | 1 |
| get_decisions | Paginated decisions log with attribution. | 1 |
| get_references | Paginated project reference list. | 1 |
| search_references | Keyword search within a project's references. | 1 |
| add_reference | Create a URL-only reference from a link. (Write) | 5 |
| log_decision | Record a brand/design decision. (Write) | 1 |
Docs
Project-scoped. Agent-ready block format.
| Tool | Purpose | Credits |
|---|---|---|
| list_docs | Every doc on a project (friendly alias of list_briefs). | 1 |
| get_doc | A doc as a block list — text + capture references + the captured code to build from, plus the sign-off signal. | 1 |
| get_project_bundle | The whole project in one call — meta, all docs, capture summaries. | 1 |
Resources
Individual captures are also available as MCP resources via the zaai-capture://{id} template, so you can attach a specific capture to a conversation from your client's resource picker.
credits
Read tools cost 1 credit per call; health and whoami are free; writes like add_reference cost more. Check your balance any time with whoami, and top up at zaaidev.com/dev/settings/billing.