@variel/mcp-server

@variel/mcp-server

The Variel MCP server — gives your coding agent live access to your brand: tokens, components, voice, and on-brand validation. It runs over stdio and resolves your brand from the Variel API using your project's API key, so there's nothing to clone and no database to point at.

Connect

Get your BRAND_API_KEY (vrl_…) from your project's Activation page in the Variel dashboard, then:

# Claude Code
claude mcp add variel -e BRAND_API_KEY=vrl_… -- npx @variel/mcp-server

For Cursor / other agents, add an mcpServers entry:

{
  "mcpServers": {
    "variel": {
      "command": "npx",
      "args": ["@variel/mcp-server"],
      "env": { "BRAND_API_KEY": "vrl_…" }
    }
  }
}

Tools

• get_brand_tokens — the live token set (colors, type, spacing, radius…)
• list_components / get_component — brand components to use before rolling your own
• validate_design — deterministic on-brand conformance for changed code
• validate_copy — voice/tone check for copy
• grade_visual_quality — model-judged visual quality (needs ANTHROPIC_API_KEY)
• propose_token — propose a new token when nothing fits

Resources: brand://voice, brand://moodboard, brand://guidelines.

Configuration

Env	Default	Purpose
BRAND_API_KEY	—	Your project key (vrl_…). Required.
VARIEL_API_URL	https://variel.ai	Override for self-host / staging.
ANTHROPIC_API_KEY	—	Required only for grade_visual_quality.
BRAND_SOURCE	(unset)	Set to db to read Postgres directly (DATABASE_URL) instead of the HTTP API — for local dev / self-host.

Without a valid key the server falls back to a neutral bootstrap brand so your agent still starts.