# Uwarp

> Uwarp is an open-source MCP server for design and media. Local MCP tools for WCAG contrast checks, HSL palettes and searching 500+ free UI tools. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Windows, Linux
- **Website:** https://uwarp.design
- **Repository:** https://github.com/sherotree/uwarp-mcp
- **MCP Registry name:** io.github.sherotree/uwarp-mcp
- **Categories:** design and media
- **Listing updated:** 2026-11-15

## About

This small stdio server runs entirely on your machine and needs no API key. Two of its three tools are pure calculation. check_contrast takes a foreground and background hex colour and returns the WCAG 2.x contrast ratio with AA and AAA flags for normal and large text, and generate_palette builds a harmony palette from a seed colour and prints a ready-made :root CSS block. The README's test confirms black on white comes out at about 21.

The third tool, search_tools, searches a catalogue of Uwarp's free browser-based design and media tools. The catalogue is a bundled local file (data/tools.json), so the server does not scrape or call the third-party tools it points to. Results include a name, summary, URL and category, with an optional category filter and a limit of 1 to 20.

Palettes support analogous, complementary, triadic and mono harmonies and 3 to 12 colours. It needs Node.js 18 or later, installs with npx -y uwarp-mcp, and is MIT licensed. UWARP_API_KEY is reserved for a future API and is ignored today.

## Features

- **Contrast checker:** Returns the WCAG ratio with AA and AAA pass flags for normal and large text.
- **Palette generator:** Creates analogous, complementary, triadic or mono palettes from a seed hex.
- **CSS variable output:** Palettes come with a :root CSS block of named colours.
- **Tool catalogue search:** Searches a bundled list of 500+ free Uwarp browser tools.
- **Fully local:** Calculations and search run on-device with no API key.

## Good for

- Check whether a text and background colour pair meets AA
- Generate a six-colour palette from a brand colour
- Find a free browser tool for a design or media task
- Drop palette CSS variables into a stylesheet

## Install

### Claude Code (Terminal)

```sh
claude mcp add uwarp-mcp -- npx -y uwarp-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "uwarp-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "uwarp-mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "uwarp-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "uwarp-mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "uwarp-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "uwarp-mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "uwarp-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "uwarp-mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "uwarp-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "uwarp-mcp"
      ]
    }
  }
}
```

## Tools

- `check_contrast`: Returns the WCAG 2.x contrast ratio and AA/AAA flags for two hex colours.
- `generate_palette`: Creates an HSL harmony palette from a seed colour with :root CSS.
- `search_tools`: Searches the bundled Uwarp tool catalogue, optionally by category.

## FAQ

### Does it need an API key?

No. The README says no paid key is required.

### Which contrast standard does it use?

WCAG 2.x relative luminance with AA and AAA thresholds.

### Does search_tools call the web?

No, it reads a bundled local catalogue.

### What do I need to run it?

Node.js 18 or later.

### Is Uwarp free?

Yes. Uwarp is open source, so you can use and self-host it for free.

### How do I add Uwarp to Claude Code?

Run this command in your terminal: claude mcp add uwarp-mcp -- npx -y uwarp-mcp

### What are the best alternatives to Uwarp?

The closest alternatives to Uwarp are HyperFrames by HeyGen, ffmpeg-skill, AvatarSay — Fictional Character & Talking Video MCP, ChartAnt and VfxSmith.

## Alternatives

- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [AvatarSay — Fictional Character & Talking Video MCP](https://ai-powered.com/mcp/avatarsay-fictional-character-and-talking-video-mcp): AvatarSay — Fictional Character & Talking Video MCP is a freemium MCP server for design and media.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [VfxSmith](https://ai-powered.com/mcp/vfxsmith): VfxSmith is a freemium MCP server for design and media.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [Eikino](https://ai-powered.com/mcp/eikino): Eikino is a freemium MCP server for security.
- [Hourlore](https://ai-powered.com/mcp/hourlore): Hourlore is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/uwarp
