# Raven

Design intelligence and UI audits for coding agents: tests markup contrast, tap targets, and design system tokens.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 6
- Author: rhinocap
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/rhinocap/raven-mcp
- Updated: 2026-09-24
- HTML: https://affpapa.org/en/nevibecode/mcp/raven

## What it does

The server equips coding assistants with a structured design database. Agents inspect user interfaces against Nielsen's 10 Heuristics, WCAG standards, and 21 UX laws. Tools like `audit_page` and `score_page` inspect static HTML or rendered pages for font choices, contrast failures, and spacing scale mistakes.

Through `evaluate_design`, agents perform visual diffs using base64 PNG images. Routing generative rendering tasks requires configuring the `RAVEN_CREATIVE_RUNNER` variable with your own credentials.

Deployment choice determines feature scope. The local stdio command unlocks 111 tools, including the Taste Engine and Grab. In contrast, the public remote endpoint offers roughly 45 stateless tools. Connecting both local and hosted endpoints at the same time duplicates tool definitions in your agent.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://mcp.ravenmcp.ai/api/mcp`

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http raven-mcp https://mcp.ravenmcp.ai/api/mcp
```

2. **Platform CLI**
```bash
claude mcp add raven -- npx -y raven-mcp
```

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add raven --url https://mcp.ravenmcp.ai/api/mcp
```

2. **Platform CLI**
```bash
codex mcp add raven -- npx -y raven-mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "raven": {
            "url": "https://mcp.ravenmcp.ai/api/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "raven": {
            "command": "npx",
            "args": [
                "-y",
                "raven-mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "raven": {
            "type": "http",
            "url": "https://mcp.ravenmcp.ai/api/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "raven": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "raven-mcp"
            ]
        }
    }
}
```

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http raven https://mcp.ravenmcp.ai/api/mcp
```

2. **Platform CLI**
```bash
gemini mcp add raven npx -y raven-mcp
```

## When to use it
- audit HTML markup against WCAG contrast and accessibility criteria
- inspect visual changes using before and after screenshot comparisons
- import UI tokens inspired by Stripe or Linear
- generate category scores from 0 to 10 for layout spacing and typography

## Example prompts
- Audit this HTML file for contrast and typography issues with `audit_page`
- Evaluate layout changes between my two UI screenshots using `evaluate_design`
- Fetch Linear design tokens to align button padding and borders

## Similar
- [Next AI Draw.io](https://affpapa.org/en/nevibecode/mcp/next-ai-drawio.md) — MCP server · ★ 36427
- [tldraw](https://affpapa.org/en/nevibecode/mcp/tldraw.md) — MCP server · ★ 51104
- [Figma-Context-MCP](https://affpapa.org/en/nevibecode/mcp/figma-context-mcp.md) — MCP server · ★ 16073
- [Agent-Native Assets](https://affpapa.org/en/nevibecode/mcp/agent-native-assets.md) — MCP server · ★ 7527
- [Remove AI Watermarks](https://affpapa.org/en/nevibecode/mcp/remove-ai-watermarks.md) — MCP server · ★ 6144
- [Dembrandt](https://affpapa.org/en/nevibecode/mcp/dembrandt.md) — MCP server · ★ 3851

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md