Primitiv vs Mozaic
A side-by-side look at the Primitiv and Mozaic MCP servers: transport, auth, tools, quality signals, and the config to install either one in Claude, Cursor, Windsurf or VS Code.
Verdict: choose Primitiv for architecture & design work as a local process; choose Mozaic for architecture & design as a local process. You can also run both side by side in one mcpServers block.
Which MCP server should you choose?
Choose Primitiv when
- You need dedicated capabilities in the Architecture & Design domain.
- You prefer a local stdio subprocess transport.
- Its auth model fits you: No auth required.
- You want tools like
get_design_context, get_token, get_component.
Choose Mozaic when
- You need dedicated capabilities in the Architecture & Design domain.
- You prefer a local stdio subprocess transport.
- You have the keys it needs:
PORT, AUTH_TOKEN, DATABASE_PATH, MCP_SERVER_PATH, MCP_DEBUG. - You want tools like
get_design_tokens, get_component_info, list_components.
Feature & specification comparison
Rows where the two servers differ are marked.
| Spec | ||
|---|---|---|
| Category | Architecture & Design | Architecture & Design |
| Quality signal | 65/100 · Great | 59/100 · Good |
| Install command | Confirmed | Confirmed |
| Transport | Local subprocess (stdio) | Local subprocess (stdio) |
| Auth | No auth required | Not declared |
| Pricing | Free | Not declared |
| Required env vars | None listed | PORTAUTH_TOKENDATABASE_PATHMCP_SERVER_PATHMCP_DEBUG |
| Verified owner | Community listing | Community listing |
| GitHub stars | 21 | 4 |
| Directory activity | 4 views 0 installs 0 upvotes | 1 views 0 installs 0 upvotes |
| Tools | 6 | 19 |
| Full listing | View Primitiv | View Mozaic |
Tools & capabilities
Primitiv tools 6
get_design_contextGet tokens, components, conflicts, inferred rules, and violation count. Default (no category) returns a summary with counts. Pass `category: "all" \get_tokenLook up a specific token by name. Pass `category` to narrow search (e.g. `"colors"`, `"spacing"`, `"borderRadius"`); aliases like `"radius"` / `"z-index"` are normalized.get_componentLook up a specific component by name. Returns props, variants, source provenance, and `kind` — `component`, `screen`, `provider`, `icon`, or `other`, so agents reuse real UI and skip screens/providers/icons.get_conflictsGet conflicts between sources. Pass `type: "all" \get_inferred_rulesGet the design rules Primitiv has extracted from your codebase patterns. Pass `category` to filter.get_violationsList token-misuse violations — hardcoded literals in source that bypass the contract, with a suggested token when one fits. Pass `category: "all" \
Mozaic tools 19
get_design_tokensQuery tokens by category (colors, typography, spacing, etc.)get_component_infoGet component props, slots, events, and documentationlist_componentsList components by category or frameworkgenerate_vue_componentGenerate Vue 3 SFC code with propsgenerate_react_componentGenerate React/TSX code with TypeScriptgenerate_webcomponentGenerate native Web Component HTML with importsget_webcomponent_infoGet attributes, slots, events, CSS propertieslist_webcomponentsList web components by categorygenerate_freemarkerGenerate Freemarker macro code with configurationget_freemarker_infoGet macro configuration options and usagelist_freemarkerList Freemarker macros by categorysearch_documentationFull-text search across 309 documentation pages- +7 more on the listing page
Ready-to-paste client configs
Paste either block (or both) into your client config, e.g. claude_desktop_config.json or ~/.cursor/mcp.json. We only show a config when the install command is confirmed.
Primitiv
{
"mcpServers": {
"ai-by-design-primitiv": {
"command": "npx",
"args": [
"-y",
"@ai-by-design/primitiv"
]
}
}
}
Mozaic
{
"mcpServers": {
"mozaic": {
"command": "npx",
"args": [
"-y",
"mozaic-mcp-server@2"
],
"env": {
"PORT": "YOUR_PORT_HERE",
"AUTH_TOKEN": "YOUR_AUTH_TOKEN_HERE",
"DATABASE_PATH": "YOUR_DATABASE_PATH_HERE",
"MCP_SERVER_PATH": "YOUR_MCP_SERVER_PATH_HERE",
"MCP_DEBUG": "YOUR_MCP_DEBUG_HERE"
}
}
}
}
Frequently asked questions
Primitiv is categorized under Architecture & Design and uses a local stdio subprocess. Mozaic belongs to Architecture & Design and uses a local stdio subprocess. Pick Primitiv for architecture & design work and Mozaic for architecture & design.
Copy the mcpServers block from the config section on this page into your client's config (for example claude_desktop_config.json or ~/.cursor/mcp.json), then fully restart the client.
Primitiv is listed as free. Auth: no auth required. Mozaic has no declared pricing — check the project's own site. If a server needs environment variables such as API keys, define them under the env key in your client's MCP config.
Yes. MCP clients support multiple servers: add ai-by-design-primitiv and mozaic as separate keys in the same mcpServers object, and your assistant will call tools from either one.
On AllMCPs, Primitiv has a quality signal of 65/100 (Great) with 4 views, 0 installs and 21 GitHub stars. Mozaic has 59/100 (Good) with 1 views, 0 installs and 4 GitHub stars.