# Basiiik

> Basiiik is an open-source MCP server for developer tools. Design system MCP server telling coding agents which React component and props to use. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Website:** https://basiiik.pages.dev
- **MCP Registry name:** io.github.shubhankarsd/basiiik
- **Categories:** developer tools, design and media
- **Listing updated:** 2026-11-16

## About

Basiiik pairs an MIT-licensed React component set with a local MCP server so an agent picks from real components instead of improvising styles. In the site's example, searching for a confirm-delete dialog returns Modal, and a snippet call yields a type-checked Modal with the destructive variant. The server runs locally with no API key and is listed in the official MCP Registry.

Each component has a JSON spec covering when to use it, props and allowed values, keyboard and ARIA rules, tokens it reads and mistakes agents commonly make. Colour, spacing, radius, type and motion are DTCG tokens, so a rebrand is a single file. The package set has 88 React components and 52 outline icons on one 16px grid.

In the vendor's own test of one prompt run five times each way, pages built without it had a median of 25 hard-coded colours, while Basiiik pages had none. The free tier covers UI, tokens, icons and MCP; a $175 Pro pack adds a Figma kit and a lint_source tool.

## Features

- **Component specs:** Per-component guidance on use, props, accessibility and pitfalls.
- **Checked snippets:** Snippets fill required props and are type-checked in tests.
- **DTCG design tokens:** Colour, spacing and type live in tokens for one-file rebrands.
- **Icon search:** 52 icons with search words and usage notes.
- **Local and keyless:** Runs over stdio with no API key.
- **Brand Mapper and Icon Lab:** Free browser tools for palettes and icon styling.

## Good for

- Have an agent build screens that follow a design system
- Look up the right component for a UI need
- Re-theme a page by changing a token
- Keep icons consistent across agent-built pages

## Install

### Claude Code (Terminal)

```sh
claude mcp add basiiik -- npx -y @basiiik/mcp
```

### Claude Desktop (claude_desktop_config.json)

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

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

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

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

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

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

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

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

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

## Tools

- `search_components`: Searches components by need.
- `get_component_snippet`: Returns a checked React snippet for a component.
- `lint_source`: Finds hard-coded values and raw elements; part of the Pro pack.

## FAQ

### Is it free?

Yes. UI, tokens, icons and the MCP server are free under the MIT licence; Pro is $175 once.

### Does it need an API key?

No, it runs locally.

### Which clients work?

Claude Code, Cursor, Windsurf, VS Code and Claude Desktop are named.

### Does it need Tailwind?

No. It uses CSS variables.

### Is Basiiik free?

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

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

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

### What are the best alternatives to Basiiik?

The closest alternatives to Basiiik 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/basiiik
