Raven MCP Server

Design intelligence for AI-generated UI — principles, patterns, content, brand, design tokens.

Remote serverstreamable-http

What is the Raven MCP server?

Most payments and commerce work still happens through a UI a human drives. Raven MCP server moves it into the conversation instead. Design intelligence for AI-generated UI — principles, patterns, content, brand, design tokens.

The short version

Raven is an MCP server for coding agents. Click any element in the app you have running locally and say what should change — Raven sends the agent the selector, the computed styles, and your design tokens — then audits the result for contrast, tap targets, and typography.

  • Content systems — — Voice & tone guides: Conversational Product Voice, GOV.UK, Shopify Polaris, and Atlassian
  • Research — — Qualitative, quantitative, and usability methods with do/don't protocols and checklists. Metrics frameworks: HEART, AARRR/Pirate, North Star Metric, conversion funnel, RICE, OKRs
  • Service design — — Service blueprinting (with HTML blueprint generation — current vs. ideal state), human-handoff patterns, signup-as-service, omnichannel continuity, moments of truth / recovery, and the GOV.UK Service Standard
  • Business — — Monetization models, retention strategies, onboarding optimization, growth mechanics, and product metrics frameworks
  • Tokens — — Design system tokens for Stripe, Linear, and more

Getting it running

Because this one is hosted, setup is mostly authentication — you point your client at the endpoint and approve access. Nothing runs on your machine, so there is no runtime to keep patched.

The tools it exposes

The server publishes 14 tools. What each one is for:

  • get_principles — Get design principles relevant to a UI context
  • get_pattern — Get proven patterns for a specific UI type
  • get_business_strategy — Get business/monetization strategies
  • evaluate_design — Evaluate a design description against principles. Pass base64 PNG screenshots (before_screenshot/after_screenshot) for a structured before/after
  • search_knowledge — Search across all principles, patterns, and strategies
  • get_checklist — Get a pre-publish checklist for a UI type
  • get_d4d_framework — Get Design for Delight framework templates
  • list_design_systems — Browse available design systems
  • get_design_system — Get tokens for a specific design system
  • compose_system — Mix tokens from different systems
  • get_brand_system — Get a full system styled like a well-known brand
  • audit_page — Audit HTML/CSS against Raven's quality standards — pass html for static audit, or url to render headless with optional scroll_settle (step through

What it needs from you

Configuration is passed through the environment: FIGMA_TOKEN. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.

Things to watch

  • Your data travels to the provider's service, so the usual questions apply about what you send and what they retain.
  • With 14 tools registered it takes up a noticeable share of the context window; turn it off in projects that never touch Raven.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

How it compares

Plenty of payments and commerce servers cover similar ground. The differences that matter in practice are scope of access and how much setup stands between you and a working tool call. Raven's toolset — get_principles, get_pattern, get_business_strategy and 11 more — is a fair guide to whether it matches your workflow. It is maintained by ai.ravenmcp; worth a glance at recent repository activity before you build anything load-bearing on it.

SyncDev reviews every entry in this directory against the project's own documentation before publishing, and revisits them as servers change.

Available tools

ToolWhat it does
get_principlesGet design principles relevant to a UI context
get_patternGet proven patterns for a specific UI type
get_business_strategyGet business/monetization strategies
evaluate_designEvaluate a design description against principles. Pass base64 PNG screenshots (before_screenshot/after_screenshot) for a structured before/after pixel diff with fix_confirmed, changed_ratio, and changed region. Pass comp
search_knowledgeSearch across all principles, patterns, and strategies
get_checklistGet a pre-publish checklist for a UI type
get_d4d_frameworkGet Design for Delight framework templates
list_design_systemsBrowse available design systems
get_design_systemGet tokens for a specific design system
compose_systemMix tokens from different systems
get_brand_systemGet a full system styled like a well-known brand
audit_pageAudit HTML/CSS against Raven's quality standards — pass html for static audit, or url to render headless with optional scroll_settle (step through reveal gates, then return to top) and viewport parameters; containerMaxWi
score_pageReturn a per-category (0–10) design score for a page — typography, accessibility, spacing, color, responsive layout, design tokens, structure — derived from the same checks as audit_page, plus the overall score/grade, th
audit_layoutEvaluate visual rhythm, alignment, and optical balance; detects orphan-stretch (a lonely last-row grid/flex card stretching far wider than siblings)

How to install the Raven MCP server

{
  "mcpServers": {
    "raven": {
      "command": "npx",
      "args": ["-y", "raven-mcp"],
      "env": {
        "FIGMA_TOKEN": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

VariableDescriptionRequired
FIGMA_TOKENCredential the server authenticates with.Yes

Example prompts to try

  • Use Raven to get principles.
  • Use Raven to get pattern.
  • Use Raven to get business strategy.

Frequently asked questions

It connects Raven to MCP-compatible AI assistants such as Claude and Cursor, exposing 14 tools (get_principles, get_pattern, get_business_strategy, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Raven directly.