English Français العربية

io.github.basalt-run/basalt

Official registry Media and design

Design tokens, components, icons, and a11y data via MCP. For Cursor, Claude, and Windsurf.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (sse)
Claude Code 
claude mcp add --transport sse basalt 'https://basalt.run/api/mcp' --header 'Authorization: <Basalt API key from https://basalt.run Settings>'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "basalt": {
            "type": "sse",
            "url": "https://basalt.run/api/mcp",
            "headers": {
                "Authorization": "<Basalt API key from https://basalt.run Settings>"
            }
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Basalt Design System
  2. What's in this repo
  3. Using these tokens with AI tools
  4. Token architecture
  5. Links
  6. License

Basalt Design System

Design tokens in Git. Readable by AI. Beautiful to edit.

This repo is managed by Basalt — a design system platform that stores tokens, components, and documentation in Git and serves them to AI coding tools via MCP.

What's in this repo

tokens/
├── primitives.json        # Raw values (colors, spacing, radii)
├── semantic.light.json    # Light theme semantic tokens
└── semantic.dark.json     # Dark theme semantic tokens

All tokens use the DTCG 2025.10 format (W3C standard).

Using these tokens with AI tools

Basalt serves this design system to Cursor, Claude Code, Claude Design, and Windsurf via an MCP server. AI tools query your real token values instead of guessing.

See MCP.md for setup instructions and available tools.

Quick config (Cursor / Claude Code / Windsurf):

{
  "mcpServers": {
    "basalt": {
      "url": "https://basalt.run/api/mcp",
      "headers": {
        "Authorization": "Bearer bsk_your_key_here"
      }
    }
  }
}

Get a free API key at basalt.run.

Token architecture

Three tiers, each referencing the layer above:

Primitive → raw values (color.orange.500 = #F97316) Semantic → intent + theming (color.action.default → color.orange.500) Component → scoped to UI elements (button.background.default → color.action.default)

AI tools resolve the full chain automatically via MCP.

License

MIT — see LICENSE.

Frequently asked questions

What is io.github.basalt-run/basalt?

Design tokens, components, icons, and a11y data via MCP. For Cursor, Claude, and Windsurf.

How do I install io.github.basalt-run/basalt?

It runs as a remote server. In Claude Code: claude mcp add --transport sse basalt 'https://basalt.run/api/mcp' --header 'Authorization: <Basalt API key from https://basalt.run Settings>'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.basalt-run/basalt need an API key?

Yes. It expects Authorization, which you set in its configuration.

Is io.github.basalt-run/basalt open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.basalt-run/basalt?

It is published by basalt-run. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.