# tesserai

> tesserai is a freemium MCP server for design and media. Gives coding agents your project's design tokens, components, contrast checks and rules. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** CLI, Web
- **Website:** https://tesserai.design/docs
- **Repository:** https://github.com/tesseraihq/tesserai/tree/HEAD/packages/cli
- **MCP Registry name:** design.tesserai/tesserai
- **Categories:** design and media, developer tools
- **Listing updated:** 2026-11-16

## About

tesserai is a command line tool that installs a design system into a project as components you own, then keeps it current. The MCP server is one of its commands: it runs locally over stdio, reads the project, and needs no model-provider API key. Running init registers it in .mcp.json, and in .cursor/mcp.json when Cursor is used.

The agent can read the system's outline, tokens, components, contrast checks and design guidelines, and apply changes that stay inside the system. Around that, the CLI offers sync, which preserves hand-edited files by writing the new version beside them as .tesserai-new; scan, which reports unused components, repeated overrides and an adoption score; doctor; export to formats including SCSS, MUI, Chakra, Swift, Kotlin and Dart; and a Storybook with accessibility checks.

It needs Node.js 22 or newer and Tailwind CSS 4. React works with Base UI, Radix or React Aria, Vue with Reka UI, and Svelte 5 with Bits UI. The CLI is MIT licensed. The site says every editing feature is free in the browser, with a Pro plan whose price is shown at launch.

## Features

- **Design context for agents:** Tokens, components, contrast checks and guidelines reach the agent over MCP.
- **Safe sync:** Hand-edited generated files are kept and the proposal written alongside.
- **Adoption scan:** Finds unused components, repeated overrides and values that bypass the system.
- **Multi-framework:** React, Vue and Svelte 5 with named primitive libraries.
- **Token export:** Exports to SCSS, TypeScript, Panda, StyleX, MUI, Mantine, Chakra, Swift, Kotlin and Dart.
- **Local server:** Runs on your machine with no model API key.

## Good for

- Keep a coding agent's UI changes on-brand
- Check that colour pairs in the system meet contrast rules
- Update an installed design system without losing local edits
- Find which components the app never uses

## Install

### Claude Code (Terminal)

```sh
claude mcp add tesserai -- npx -y @tesserai/cli
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "tesserai": {
      "command": "npx",
      "args": [
        "-y",
        "@tesserai/cli"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "tesserai": {
      "command": "npx",
      "args": [
        "-y",
        "@tesserai/cli"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "tesserai": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@tesserai/cli"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "tesserai": {
      "command": "npx",
      "args": [
        "-y",
        "@tesserai/cli"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "tesserai": {
      "command": "npx",
      "args": [
        "-y",
        "@tesserai/cli"
      ]
    }
  }
}
```

## FAQ

### What do I need to run it?

Node.js 22 or newer and a project using Tailwind CSS 4.

### How do I add the MCP server by hand?

Run claude mcp add tesserai -- npx -y @tesserai/cli mcp.

### Is an account required?

Designing and downloading a system needs no account; private systems use login.

### What licence is the CLI under?

MIT, and the generated components and CSS are yours to use.

### Is tesserai free?

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

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

Run this command in your terminal: claude mcp add tesserai -- npx -y @tesserai/cli

### What are the best alternatives to tesserai?

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

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.

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