{
  "markdown": "# Basalt Design System\n\nDesign tokens in Git. Readable by AI. Beautiful to edit.\n\nThis repo is managed by [Basalt](https://basalt.run) — a design system platform that stores tokens, components, and documentation in Git and serves them to AI coding tools via MCP.\n\n## What's in this repo\n\n```\ntokens/\n├── primitives.json        # Raw values (colors, spacing, radii)\n├── semantic.light.json    # Light theme semantic tokens\n└── semantic.dark.json     # Dark theme semantic tokens\n```\n\nAll tokens use the [DTCG 2025.10](https://tr.designtokens.org/format/) format (W3C standard).\n\n## Using these tokens with AI tools\n\nBasalt 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.\n\nSee **[MCP.md](MCP.md)** for setup instructions and available tools.\n\n**Quick config (Cursor / Claude Code / Windsurf):**\n\n```json\n{\n  \"mcpServers\": {\n    \"basalt\": {\n      \"url\": \"https://basalt.run/api/mcp\",\n      \"headers\": {\n        \"Authorization\": \"Bearer bsk_your_key_here\"\n      }\n    }\n  }\n}\n```\n\nGet a free API key at [basalt.run](https://basalt.run).\n\n## Token architecture\n\nThree tiers, each referencing the layer above:\n\n**Primitive** → raw values (`color.orange.500` = `#F97316`)\n**Semantic** → intent + theming (`color.action.default` → `color.orange.500`)\n**Component** → scoped to UI elements (`button.background.default` → `color.action.default`)\n\nAI tools resolve the full chain automatically via MCP.\n\n## Links\n\n- [basalt.run](https://basalt.run) — visual editor, component registry, MCP server\n- [MCP.md](MCP.md) — MCP server docs and setup\n- [MCP Registry](https://registry.modelcontextprotocol.io/) — search for `basalt`\n\n## License\n\nMIT — see [LICENSE](LICENSE).\n",
  "bytes": 1766,
  "sha": "0894605c4777e9a716990bfee199665e5d29ffdeddf1d3659768fd11543a23fe",
  "repo_slug": "basalt-run/design-system",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_basalt_run_basalt_69a598e1/readme"
}