Basalt

io.github.basalt-runPublished by GitHub account basalt-runv1.0.0Updated Oct 27, 2026

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

VerifiedSSEWeb executableDeveloper ToolsMedia & Design

Overview

AI-generated overview

Basalt serves a Git-backed design system — tokens, components, icons and accessibility data — to AI coding tools over a remote MCP endpoint.

What you can do
  • Query design tokens stored in the DTCG format, including primitive, semantic and component tiers
  • Resolve token reference chains so the assistant works with real values instead of guessing
  • Look up components, icons and accessibility data from the design system
  • Use the results while writing UI code in tools such as Cursor, Claude Code or Windsurf
When to use it
Useful when an assistant writes or edits front-end code against a specific design system and needs the project's actual token names and values, component definitions or accessibility data rather than invented ones.
Requirements
A remote MCP endpoint at basalt.run, reachable over SSE, with an Authorization header carrying a Basalt API key (a free key is available from the service's settings). No local package or runtime is needed.
Before you install
The connection requires a Basalt API key sent in the Authorization header; treat it as a secret and avoid sharing configs that contain it. The design system content is served from Basalt's hosted service, so token and component data is sent to that third party.

Installation

In SourceWeft

  1. Open Basalt in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via SSE. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.basalt-run%2Fbasalt/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "basalt": {
      "type": "sse",
      "url": "https://basalt.run/api/mcp"
    }
  }
}

README

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):

json
{  "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.

Links

License

MIT — see LICENSE.

Source: README.md at commit 353da52

Tools

0
SourceWeft has not read this server's tools yet.

Version history

1
  1. v1.0.0LatestSep 16, 2026

Score

85% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts