Skip to content
MCP server

Uxui Principles

Look up 195 cited UX/UI principles, UX smells and flow checklists in English or Spanish

Runs locallyStatus and history
Install
Pricing
Freemium
Platforms
CLI, macOS, Windows
Runs
Locally
Version
1.3.0
Listing updated
3 days ago

About Uxui Principles

Uxui Principles is a freemium MCP server for design and media. It runs locally on your machine and is started by your AI client.

Designers and developers often know a usability rule exists but not its source. This server ships a dataset of 195 principles inside the npm package, each with summary, part, difficulty, citations and a link, so a coding assistant can cite them while it works. It makes no network call in free mode.

Beyond principles it includes 12 UX smells, each with symptoms and a fix recipe, and 12 flow checklists for pre-flight and post-flight review of flows. Describe a UI complaint and the matching smells come back with confidence levels and suggested fixes. Every one of the 14 tools accepts an en or es locale.

A Principles Library key, listed at $59 a year, switches on pro mode through the uxuiprinciples.com API: full guide bodies, AI prompts for each principle, an audit_interface call that audits a described screen and maps findings to principles and smells, and a check_requirements call that tests required-state rules. If the API is unreachable, the guide tools fall back to the free answer and report the failure. Requirements are Node.js 18 or newer.

Install

Run in a terminal

claude mcp add uxui-principles --env UXUI_API_KEY='<UXUI_API_KEY>' -- npx -y @uxuiprinciples/mcp-server

Add to claude_desktop_config.json

{
  "mcpServers": {
    "uxui-principles": {
      "command": "npx",
      "args": [
        "-y",
        "@uxuiprinciples/mcp-server"
      ],
      "env": {
        "UXUI_API_KEY": "<UXUI_API_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "uxui-principles": {
      "command": "npx",
      "args": [
        "-y",
        "@uxuiprinciples/mcp-server"
      ],
      "env": {
        "UXUI_API_KEY": "<UXUI_API_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "uxui-principles": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@uxuiprinciples/mcp-server"
      ],
      "env": {
        "UXUI_API_KEY": "<UXUI_API_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "uxui-principles": {
      "command": "npx",
      "args": [
        "-y",
        "@uxuiprinciples/mcp-server"
      ],
      "env": {
        "UXUI_API_KEY": "<UXUI_API_KEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "uxui-principles": {
      "command": "npx",
      "args": [
        "-y",
        "@uxuiprinciples/mcp-server"
      ],
      "env": {
        "UXUI_API_KEY": "<UXUI_API_KEY>"
      }
    }
  }
}

Configuration

  • UXUI_API_KEYOptional. Principles Library API key from uxuiprinciples.com/account. Unlocks full guide bodies, AI prompts, audit_interface and check_requirements. Without it the server runs offline on the bundled dataset.

Tools this server provides (4)

Taken from the project documentation; the running server may differ.

get_principle
Returns one principle with summary, citations and link; full guide body in pro mode.
get_principle_prompts
Returns the principle's AI prompts in pro mode, a guide link in free mode.
audit_interface
Audits a described screen and maps findings to principles and smells; needs a key.
check_requirements
Checks required-state rules with citations; needs a key.

What it does

195 cited principles
Each has a summary, part, difficulty, citations and a link to the full guide.
UX smell matching
Maps a described UI problem to smells with confidence levels and fix recipes.
Flow checklists
Provides 12 pre-flight and post-flight checklists for common flows.
Offline by default
The dataset ships in the package and free mode makes no network calls.
Bilingual
Every tool accepts English or Spanish.
Pro audits
With a key, audits a described screen and checks required-state rules.

Good for

  • Cite the research behind a design decision in a code review
  • Diagnose why a form feels confusing
  • Run a pre-launch checklist for a checkout flow
  • Audit a described interface against known principles

Pricing

Freemium

Free offline mode; Principles Library key $59 per year unlocks full guides and audits

Prices change. Check uxuiprinciples.com before you buy.

Uxui Principles FAQ

Is it free?

Free mode is offline and covers metadata, summaries and citations. A $59 per year Principles Library key adds the guide bodies, prompts, audit and requirements check.

How many tools does it have?

14, all read-only.

Does it call the internet?

Not in free mode. With a key, three or four tools use the uxuiprinciples.com API.

Which editors work?

Claude Code, Claude Desktop, Cursor, VS Code and Windsurf.

Is Uxui Principles free?

Uxui Principles has a free plan, with paid plans for more usage or features.

How do I add Uxui Principles to Claude Code?

Run this command in your terminal: claude mcp add uxui-principles --env UXUI_API_KEY='<UXUI_API_KEY>' -- npx -y @uxuiprinciples/mcp-server

What are the best alternatives to Uxui Principles?

The closest alternatives to Uxui Principles are REA, HyperFrames by HeyGen, Codebase Memory, GitHub and Serena MCP: the IDE for your agent.

Alternatives to Uxui Principles

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Hosted MCP connector for creating and rendering videos from HTML through AI chat

    • Remote
    • Freemium
    • 85.3K GitHub stars
    • Design and media
  3. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  4. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  5. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  6. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory