MozaikaDocs

Docs - the Mozaika MCP, tool by tool

10 tools - 5 common questions

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.

Open in Mozaika →

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.