Uxui Principles
Look up 195 cited UX/UI principles, UX smells and flow checklists in English or Spanish
- 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-serverAdd 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

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

HyperFrames by HeyGen
MCP serverHosted MCP connector for creating and rendering videos from HTML through AI chat
- Remote
- Freemium
- 85.3K GitHub stars
- Design and media

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory