forgekit-radix-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@forgekit-radix-mcp get the Tooltip primitive"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
forgekit-radix-mcp
Radix Primitives' APIs and accessibility contracts, exposed to AI coding agents.
Coding agents (Claude Code, Cursor) routinely hallucinate Radix prop names, drop required parts, and miss the ARIA/keyboard contract of a primitive. There's no machine-readable source of truth for how to use Radix correctly — only prose docs an agent has to guess from.
forgekit-radix-mcp is an MCP server that gives an agent the real thing: each primitive's parts, props, and — the part nobody else ships — its accessibility contract and the common mistakes to avoid.
My coding agent stopped hallucinating Radix props — and now it knows a tooltip isn't a label.
Part of ForgeKit. MIT licensed.
Why
Props can be inferred from types. The accessibility contract can't — that's hand-authored knowledge: which Provider is required, which part supplies the accessible name, what the keyboard model is, and the misuse that quietly breaks a11y (a Tooltip used as a label, a Popover that auto-opens a nested Tooltip, a Select with an empty-string item value). This server encodes that so agents generate correct, accessible Radix code on the first try.
Related MCP server: MCP Vue UI Kit Server
Install
npm i -g forgekit-radix-mcp
# or run on demand
npx forgekit-radix-mcpRegister with an MCP client
Claude Code / Cursor (stdio server):
{
"mcpServers": {
"radix": {
"command": "npx",
"args": ["-y", "forgekit-radix-mcp"]
}
}
}Tools
Tool | Returns |
| Every documented primitive + one-line description |
| Parts, props by part, a11y contract, and a correct example |
| Just the accessibility contract — highest-signal payload |
Example
Agent call:
get_primitive { "name": "Tooltip" }Returns (abridged):
{
"name": "Tooltip",
"import": "import { Tooltip } from 'radix-ui';",
"parts": ["Provider", "Root", "Trigger", "Portal", "Content", "Arrow"],
"a11yContract": {
"roles": "Content renders role=\"tooltip\"; Trigger gets aria-describedby when open",
"keyboard": ["Tab: focus the trigger → opens instantly", "Escape: closes"],
"focus": "Opens on focus AND hover; focus never moves into the tooltip",
"requires": ["Tooltip.Provider must wrap the app once"],
"commonMistakes": [
"Using a tooltip for essential/interactive content (use Popover/HoverCard)",
"Wrapping a disabled button directly — it fires no focus/hover events",
"Using a tooltip as the only label for an icon button"
]
},
"correctExample": "<Tooltip.Provider> ... </Tooltip.Provider>"
}Coverage
26 primitives. Dialog · AlertDialog · Popover · Tooltip · HoverCard · DropdownMenu · ContextMenu · Menubar · NavigationMenu · Select · Tabs · Accordion · Collapsible · Checkbox · RadioGroup · Switch · Toggle · ToggleGroup · Slider · Toast · Progress · Avatar · Label · Separator · AspectRatio · ScrollArea.
Data reflects the radix-ui public API and the WAI-ARIA Authoring Practices.
Pairs with WorkOS AuthKit MCP
For agents that act on behalf of a user, AuthKit MCP handles secured, tool-scoped access — forgekit-radix-mcp is a read-only knowledge server that slots cleanly behind it.
Development
npm install
npm run build
npm testAvailable Tools
3 toolsget_a11y_contractA
Get just the accessibility contract for a primitive — roles, keyboard interactions, focus behavior, structural requirements, and the common mistakes to avoid. The highest-signal payload when wiring a component accessibly.
Inputs: name (required).
get_primitiveA
Get full metadata for a Radix primitive: composable parts, props by part, the accessibility contract, and a correct minimal example. Use before writing or editing any Radix component.
Inputs: name (required).
list_primitivesA
List every documented Radix primitive with a one-line description. Call this first to discover what is available.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
Each tool has a distinct, non-overlapping purpose: listing all primitives, getting full metadata for one, and retrieving only the accessibility contract. No ambiguity.
All tool names follow a consistent verb_noun pattern: list_primitives, get_primitive, get_a11y_contract. Perfectly predictable.
3 tools is ideal for a focused server that provides read-only access to primitive metadata. Each tool is essential and the set is well-scoped.
Covers discovery (list), full retrieval (get), and targeted contract retrieval for accessibility. Minor gap: no search or filtering, but the set is functionally complete for the intended use case.
Related MCP Connectors
Serves your design system and coding standards to coding agents, so they stop guessing.
Live React design-system APIs, patterns, and code validation so AI agents build real UI, not slop.
Give AI agents your deeepSpace design system: components, tokens, styles and code mappings.
Provide your AI coding tools with token-efficient access to up-to-date technical documentation for…
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceProvides AI assistants with access to private React component library documentation, props, and code examples through type-safe TypeScript integration.-
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to access documentation of Vue UI components, including props, events, and slots, for generating correct usage code.7MIT
- AlicenseAqualityDmaintenanceEnables AI assistants to access and work with Radix UI libraries (Themes, Primitives, Colors) by retrieving components, documentation, and installation guides through the Model Context Protocol.11115 npm8MIT
- AlicenseNot gradedqualityBmaintenanceProvides a real API for coding agents to look up design system components, props, and tokens, preventing guessed answers.9MIT