Docs - the Mozaika MCP, tool by tool
Tool reference and workflows for the Mozaika MCP: 10 tools that give an AI coding agent measured design systems, decoded sections, user flows and component recipes from real shipped products.
This is a static, crawlable rendering for search & AI engines. The interactive version — filters, live decode console, copy & export — is at https://mozaika.design/docs.
Quickstart
Point any MCP client at https://mozaika.design/mcp with your bearer token. A free account gets a real key with no card. The Skill installs on its own: npx skills add https://github.com/sezabut/mozaika-design.
Tool reference
search_screens(query, kind, section_type, page_type, limit)- Find real screens or sliced sections — dark dashboards, fintech onboarding, pricing cards, empty states. Returns structured metadata + image URLs.
get_design_system(site, format)- A product's decoded system: color roles, fonts, type scale, spacing, radii, buttons — raw or as DESIGN.md / Tailwind v4 / CSS vars / W3C tokens.
get_product(site) · get_section(site, type)- The whole product as a build kit — every page + section grouped by type — or one canonical section with its spec and tokens in a single call.
compare_sections(section_type, scheme)- The same section across many products, ranked, each with pixel-measured DNA — study how the best solve it before you build.
get_screen(slug) · get_screen_sections(slug)- The full decoded blueprint of one screen: layout, UX patterns, UI elements, and its sliced sections.
list_user_flows() · get_user_flow(slug)- Ordered, real product journeys — signup → onboarding → dashboard, browse → checkout. Build the whole flow, not one isolated screen.
get_recipe(site, recipe_type)- Full composed-pattern kit: the measured anatomy tree (overlay/input/row/…), the open MOTION, every state, and a live webm — plus the product's design tokens. The part a screenshot can't carry.
compare_recipes(recipe_type, industry, scheme, limit)- One pattern across products — read the library from the motion (who springs, who eases, who doesn't animate), then get_recipe(site, recipe_type) for the full kit.
get_score(site, refresh)- A 0-100 design audit measured from the live DOM — real contrast pairs, type ladder, spacing grid, motion — percentile-ranked against the measured web, with an evidence-anchored fix list your agent can apply.
get_asset_pack(slug) · generate_asset(subjects, style_from)- On-brand AI icon sets: ready-made packs are free; generate your own subjects in a decoded brand's measured style or a house style — every set struck from one frozen capsule, vision-QA gated.
Questions
- Is there a free tier?
- Yes, and it includes the MCP. A free account gets a real MCP key with no card: 25 tool calls a month against a rotating shelf of 30 decoded design systems, and unlimited search. The full gallery is open to browse either way. Paid plans lift the call limit and open the whole library.
- Which tools does the MCP work with?
- Anything that speaks MCP over Streamable HTTP: Claude Code, Cursor, VS Code, Windsurf, Claude Desktop, Raycast, Codex, Cline, Zed, and more. Point the client at https://mozaika.design/mcp with your bearer token (Claude Desktop bridges via mcp-remote).
- Do I need an account to use the Skill?
- No. The Skill's craft rules and research method install and work immediately with npx skills add. Connecting the MCP adds the live library — real decoded design systems and sections — but the method works without it.
- How is this different from other design-inspiration tools?
- We're not the first design MCP, and we're not the biggest by raw count. Our bet is depth per product and the AI-coding focus: every product is decoded into an agent-applyable design system, and pages are sliced into searchable sections, so your agent applies a real spec instead of eyeballing a screenshot. Plus a one-time Founder License instead of a subscription.
- Is my MCP token safe to share?
- Treat it like a password — anyone with it can use your access. You can regenerate it any time from the Connect page; the old token stops working immediately.