# io.github.elsahafy/ux-mcp-server (npm · @elsahafy/ux-mcp-server)

UX toolkit: 28 knowledge resources, 23 analysis tools & 4 workflow prompts for any MCP client

- Trust score: 71/100 (medium)
- Change this week: +18
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- npm · `@elsahafy/ux-mcp-server`: 71/100 (this document), [markdown](https://verifymcp.io/servers/elsahafy-ux-mcp-server/elsahafy-ux-mcp-server.md), [page](https://verifymcp.io/servers/elsahafy-ux-mcp-server/elsahafy-ux-mcp-server)

## Channel facts

- Registry: `npm`
- Package: `@elsahafy/ux-mcp-server`
- Version: `4.1.1`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Supply Chain Security**: 86/100
  - No malware found by supply-chain analysis.
  - Only part of the dependency tree could be resolved (94 of 98), so this covers what we could see, not the whole tree.
  - No install/post-install scripts declared.
  - Only part of the dependency tree could be resolved (94 of 98), so this covers what we could see, not the whole tree.
- **Provenance & Transparency**: 45/100
  - Source repository is publicly reachable at the declared URL.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 123 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 85/100
  - 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).
  - AI-judged instruction clarity (excellent).
  - Tool/resource definitions use about 2524 tokens (~42/item across 59 items; 23 tools + 36 resources), lean.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 27/100
  - Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

## Install

### Claude

```bash
claude mcp add elsahafy-ux-mcp-server -- npx -y @elsahafy/ux-mcp-server
```

### Codex

```bash
codex mcp add elsahafy-ux-mcp-server -- npx -y @elsahafy/ux-mcp-server
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "elsahafy-ux-mcp-server": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@elsahafy/ux-mcp-server"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add elsahafy-ux-mcp-server --command npx --arg -y --arg @elsahafy/ux-mcp-server
```

### Hermes

```yaml
mcp_servers:
  elsahafy-ux-mcp-server:
    command: "npx"
    args: ["-y", "@elsahafy/ux-mcp-server"]
```

### Other

```json
{
  "mcpServers": {
    "elsahafy-ux-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@elsahafy/ux-mcp-server"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-03 (score 71, +1)

No change was recorded against any check on this day. Stability & Change Management went from 23 to 27. That category is still filling its 30-day observation window: 7 days of observed history at the previous scan, 8 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-08-02 (score 70, +24)

- [security regression] Provenance: unverified → fail
- [security improvement] Install scripts: unverified → pass
- [security improvement] Known CVEs: unverified → partial
- [security] Stability: Stability not yet verified: we do not have a sandbox capture of the MCP schema this version of the package serves yet.
- [functional regression] Capabilities: pass → unverified
- [functional improvement] Schema quality: unverified → excellent
- [functional improvement] License: unverified → pass
- [functional improvement] Stability: unverified → 0.23
- [functional improvement] Dependency health: unverified → partial
- [functional improvement] Maintenance: unverified → pass
- [functional] Licence: MIT

### 2026-08-01 (score 46, +20)

- [security improvement] Malware scan: unverified → pass
- [security] Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window).
- [functional improvement] MCP protocol: unverified → pass

### 2026-07-31 (score 26, −27)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-27 (score 53)

First indexed and scored.

## MCP tools (23)

### `analyze_accessibility` (~58 tokens)

Analyze HTML/JSX code for accessibility issues based on WCAG guidelines. Returns specific violations and suggestions.

Input parameters:

- `code` (string, required): HTML or JSX code to analyze
- `level` (string): WCAG conformance level to check against

### `review_usability` (~78 tokens)

Review a UI description or code against Nielsen's usability heuristics. Provides ratings and specific recommendations.

Input parameters:

- `code` (string): Optional: Code implementation to review
- `description` (string, required): Description of the UI or component to review
- `focus_heuristics` (array): Optional: Specific heuristics to focus on (1-10)

### `suggest_pattern` (~72 tokens)

Suggest appropriate UI pattern for a given use case. Returns pattern details, best practices, and implementation guidance.

Input parameters:

- `constraints` (string): Optional: Specific constraints or requirements
- `use_case` (string, required): Description of what you're trying to build (e.g., 'user navigation', 'form validation', 'data display')

### `generate_component_example` (~94 tokens)

Generate framework-agnostic HTML/CSS example following UX best practices for a specific pattern.

Input parameters:

- `include_accessibility` (boolean): Include ARIA attributes and accessibility features
- `pattern` (string, required): Pattern name (e.g., 'search', 'modal', 'form', 'button', 'data-table')
- `variant` (string): Optional: Specific variant (e.g., 'primary', 'ghost', 'inline')

### `audit_design_system` (~54 tokens)

Audit design system implementation for consistency with best practices. Checks tokens, naming, and structure.

Input parameters:

- `tokens` (string, required): JSON or CSS of design tokens to audit
- `type` (string): Type of tokens to audit

### `check_contrast` (~82 tokens)

Check color contrast ratio for WCAG compliance. Supports hex, rgb, and named colors.

Input parameters:

- `background` (string, required): Background color
- `foreground` (string, required): Foreground color (text)
- `large_text` (boolean): Is the text large (18pt+ or 14pt+ bold)?
- `level` (string): WCAG level to check

### `check_responsive` (~57 tokens)

Analyze code for mobile-first principles and responsive design issues. Checks viewport meta, touch targets, and breakpoints.

Input parameters:

- `check_type` (string): Specific responsive aspect to check
- `code` (string, required): HTML/CSS code to analyze

### `suggest_error_message` (~91 tokens)

Get user-friendly error message suggestions for specific scenarios. Returns message, tone guidance, and accessibility considerations.

Input parameters:

- `context` (string): Optional: Additional context about the error
- `scenario` (string, required): Error scenario (e.g., 'invalid email', 'required field', 'payment failed', 'file too large')
- `technical_message` (string): Optional: Technical error message to translate to user-friendly language

### `analyze_performance` (~60 tokens)

Analyze code for performance issues and Core Web Vitals optimization. Checks resource loading, image optimization, and rendering performance.

Input parameters:

- `check_type` (string): Specific performance aspect to check
- `code` (string, required): HTML/CSS/JS code to analyze

### `check_seo` (~55 tokens)

Analyze HTML for SEO best practices. Checks meta tags, Open Graph, structured data, and technical SEO elements.

Input parameters:

- `html` (string, required): HTML code to analyze
- `url` (string): Optional: Page URL for context

### `suggest_animation` (~73 tokens)

Suggest appropriate animation for a UI interaction. Returns animation type, duration, easing, and implementation guidance.

Input parameters:

- `context` (string): Optional: Additional context about the interaction
- `interaction` (string, required): UI interaction to animate (e.g., 'button click', 'modal open', 'list item add', 'page transition')

### `generate_color_palette` (~80 tokens)

Generate accessible color palette from a base color. Returns primary, secondary, neutral, and semantic colors with WCAG-compliant variations.

Input parameters:

- `base_color` (string, required): Base color (hex, rgb, or color name)
- `harmony_type` (string): Color harmony type to generate
- `include_neutrals` (boolean): Include grayscale neutrals

### `generate_typography_scale` (~95 tokens)

Calculate modular typography scale with recommended sizes for headings and body text. Returns complete type scale with line heights.

Input parameters:

- `base_size` (number): Base font size in pixels (typically 16)
- `scale_ratio` (number): Scale ratio (e.g., 1.2 for minor third, 1.5 for perfect fifth)
- `steps` (number): Number of steps to generate (up and down from base)

### `suggest_microcopy` (~84 tokens)

Suggest user-friendly microcopy for UI elements. Returns context-aware suggestions for buttons, labels, messages, and help text.

Input parameters:

- `context` (string, required): Context of the element (e.g., 'login button', 'email field', 'payment success')
- `element_type` (string, required): Type of UI element needing copy
- `tone` (string): Desired tone of voice

### `suggest_form_pattern` (~79 tokens)

Recommend optimal form layout and validation pattern. Returns layout recommendations, field types, and validation strategies.

Input parameters:

- `field_count` (number): Approximate number of fields
- `form_type` (string, required): Type of form (e.g., 'login', 'registration', 'checkout', 'contact', 'search')
- `platform` (string): Target platform

### `analyze_data_viz` (~106 tokens)

Review data visualization for accessibility and clarity. Checks chart type appropriateness, color usage, labels, and accessibility.

Input parameters:

- `chart_type` (string, required): Type of chart/visualization (e.g., 'bar chart', 'line chart', 'pie chart', 'scatter plot')
- `data_description` (string, required): Description of the data being visualized
- `purpose` (string): Purpose of the visualization (e.g., 'comparison', 'trend', 'composition', 'distribution')

### `generate_accessibility_report` (~61 tokens)

Generate comprehensive accessibility audit report. Checks WCAG compliance, keyboard navigation, screen reader compatibility, and semantic HTML.

Input parameters:

- `url` (string, required): URL or page identifier to audit
- `wcag_level` (string): WCAG compliance level to check against

### `suggest_ab_variant` (~107 tokens)

Suggest A/B test variants for optimization. Provides hypothesis, variant designs, and metrics to track.

Input parameters:

- `current_performance` (string): Current metric (e.g., '2% conversion rate', '60% bounce rate')
- `element` (string, required): Element to test (e.g., 'CTA button', 'headline', 'pricing page', 'checkout flow')
- `goal` (string, required): Desired outcome (e.g., 'increase conversions', 'reduce bounce', 'improve engagement')

### `analyze_information_architecture` (~71 tokens)

Analyze and suggest improvements to information architecture. Reviews navigation, labeling, hierarchy, and content organization.

Input parameters:

- `issues` (string): Known issues or pain points (optional)
- `site_structure` (string, required): Description or sitemap of current structure
- `user_goals` (string, required): Primary user goals and tasks

### `detect_dark_patterns` (~69 tokens)

Detect dark patterns and ethical design violations. Identifies manipulative UI practices and suggests ethical alternatives.

Input parameters:

- `flow_description` (string, required): Description of user flow or interface (e.g., 'subscription cancellation', 'cookie consent', 'checkout')
- `screenshot_url` (string): URL to screenshot (optional)

### `calculate_ux_metrics` (~105 tokens)

Calculate key UX metrics and benchmarks. Computes SUS score, NPS, task success rate, and provides interpretation.

Input parameters:

- `data` (string, required): Raw data (e.g., 'SUS responses: 4,2,5,4,3,2,5,4,4,3' or 'NPS scores: 9,8,10,7,6,9,10')
- `metric_type` (string, required): Type of UX metric to calculate

### `generate_wireframe` (~98 tokens)

Generate ASCII wireframe mockup for a page or component. Creates low-fidelity layout sketch using text characters.

Input parameters:

- `elements` (string): Key elements to include (e.g., 'logo, search bar, user menu, main content area')
- `layout` (string): Overall layout structure
- `page_type` (string, required): Type of page/component (e.g., 'login page', 'dashboard', 'product card', 'navigation header')

### `suggest_microinteraction` (~90 tokens)

Suggest microinteractions for UI elements. Provides animation, feedback, and transition recommendations.

Input parameters:

- `context` (string): Context of interaction (e.g., 'delete action', 'successful save', 'error state')
- `element` (string, required): UI element (e.g., 'button', 'toggle switch', 'like button', 'form submission', 'loading')
- `platform` (string): Target platform

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/elsahafy-ux-mcp-server/elsahafy-ux-mcp-server#diagnostics

## Score history

- 2026-08-03: 71
- 2026-08-02: 70
- 2026-08-01: 46
- 2026-07-31: 26
- 2026-07-30: 53
- 2026-07-28: 53
- 2026-07-27: 53

## Links

- npm package: https://www.npmjs.com/package/@elsahafy/ux-mcp-server
- Socket report: https://socket.dev/npm/package/@elsahafy/ux-mcp-server
- Repository: https://github.com/elsahafy/ux-mcp-server
- Changelog RSS feed: https://verifymcp.io/servers/elsahafy-ux-mcp-server/elsahafy-ux-mcp-server/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/elsahafy-ux-mcp-server/elsahafy-ux-mcp-server/changelog.json
- HTML version of this page: https://verifymcp.io/servers/elsahafy-ux-mcp-server/elsahafy-ux-mcp-server