Ref Tools Ref Tools MCP vs Primitiv
A side-by-side look at the Ref Tools Ref Tools MCP and Primitiv MCP servers: transport, auth, tools, quality signals, and the config to install either one in Claude, Cursor, Windsurf or VS Code.
Verdict: choose Ref Tools Ref Tools MCP for finance & fintech work as a local process; choose Primitiv 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 Ref Tools Ref Tools MCP when
- You need dedicated capabilities in the Finance & Fintech domain.
- You prefer a local stdio subprocess transport.
- You have the keys it needs:
REF_API_KEY. - You want tools like
query, url.
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.
Feature & specification comparison
Rows where the two servers differ are marked.
| Spec | ||
|---|---|---|
| Category | Finance & Fintech | Architecture & Design |
| Quality signal | 63/100 · Good | 65/100 · Great |
| Install command | Confirmed | Confirmed |
| Transport | Local subprocess (stdio) | Local subprocess (stdio) |
| Auth | Not declared | No auth required |
| Pricing | Not declared | Free |
| Required env vars | REF_API_KEY | None listed |
| Verified owner | Community listing | Community listing |
| GitHub stars | 1,183 | 21 |
| Directory activity | 2 views 0 installs 0 upvotes | 4 views 0 installs 0 upvotes |
| Tools | 2 | 6 |
| Full listing | View Ref Tools Ref Tools MCP | View Primitiv |
Tools & capabilities
Ref Tools Ref Tools MCP tools 2
queryurl
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" \
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.
Ref Tools Ref Tools MCP
{
"mcpServers": {
"ref-tools-ref-tools-mcp": {
"command": "npx",
"args": [
"ref-tools-mcp@latest"
],
"env": {
"REF_API_KEY": "YOUR_REF_API_KEY_HERE"
}
}
}
}
Primitiv
{
"mcpServers": {
"ai-by-design-primitiv": {
"command": "npx",
"args": [
"-y",
"@ai-by-design/primitiv"
]
}
}
}
Frequently asked questions
Ref Tools Ref Tools MCP is categorized under Finance & Fintech and uses a local stdio subprocess. Primitiv belongs to Architecture & Design and uses a local stdio subprocess. Pick Ref Tools Ref Tools MCP for finance & fintech work and Primitiv 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.
Ref Tools Ref Tools MCP has no declared pricing — check the project's own site. Primitiv is listed as free. Auth: no auth required. 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 ref-tools-ref-tools-mcp and ai-by-design-primitiv as separate keys in the same mcpServers object, and your assistant will call tools from either one.
On AllMCPs, Ref Tools Ref Tools MCP has a quality signal of 63/100 (Good) with 2 views, 0 installs and 1,183 GitHub stars. Primitiv has 65/100 (Great) with 4 views, 0 installs and 21 GitHub stars.