# onsystem

> onsystem is an open-source MCP server for developer tools. Flags hardcoded colours and unknown components in agent-written React UI code. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, vscode, self-hosted
- **Website:** https://onsystem.vercel.app
- **Repository:** https://github.com/dgesteves/onsystem
- **MCP Registry name:** io.github.dgesteves/onsystem
- **Categories:** developer tools
- **Listing updated:** 2026-11-14

## About

Coding agents write UI from training data, so a settings card tends to arrive with bg-[#ef4444], p-[13px], a native button and a variant your Button never had. onsystem reads your design-system package with the TypeScript compiler and checks the agent's .tsx and .jsx output against what actually exists.

Its MCP server shows the agent your components, cva and tv variants, parts and tokens before it writes, and a check_ui call returns findings with a rule id, a location and a fix. Rules named on the site include no-hardcoded-color, no-hardcoded-spacing, no-unknown-component, no-unknown-prop, no-unknown-variant, icon-button-accessible-name and prefer-design-system-component. Tokens can come from stylesheets, DTCG files or a DESIGN.md.

Checks run locally with no model calls; the site cites 1.8 ms on its demo file. A Claude Code plugin adds a hook that checks every edit, and a GitHub Action checks only the lines a pull request changes. Setup is done once in the design-system package so each app in a monorepo inherits it. It works with shadcn/ui, a custom package or MUI.

## Features

- **check_ui tool:** Returns findings with a rule id, location and suggested fix for a file.
- **Design-system lookup:** Shows the agent your components, variants, parts and tokens before it writes UI.
- **Edit-time hook:** The Claude Code plugin checks each edit the agent makes.
- **Pull request check:** A GitHub Action checks only changed lines and fails on errors.
- **Token sources:** Reads stylesheets, DTCG files or a DESIGN.md, and can export tokens back out.
- **Runs locally:** No model calls; the check is a local static analysis.

## Good for

- Stop agents from writing hex colours and arbitrary spacing in React components
- Catch invented variants or props before review
- Enforce a shared design system across every app in a monorepo
- Fail a pull request when agent-written UI bypasses the design system

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

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

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

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

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

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

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

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

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

## Tools

- `check_ui`: Check a file against the design system and return findings with fixes

## FAQ

### Does it send my code to a model?

No. The site says it runs locally with no model calls.

### Which design systems does it support?

The site names shadcn/ui, your own package or MUI.

### How do I install it?

Run npx -y onsystem as a stdio server, or install the Claude Code plugin from the dgesteves marketplace.

### Can it run in CI?

Yes, through the dgesteves/onsystem GitHub Action, which checks the lines a pull request changes.

### Is onsystem free?

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

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

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

### What are the best alternatives to onsystem?

The closest alternatives to onsystem are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [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.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

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