Ballmac UI home
Get Pro
View as Markdown

Use the shadcn MCP server

Ballmac UI is a standard shadcn registry, so the official shadcn MCP server works once the registry is in your project.

On this page

Add the registry to your project

The shadcn CLI knows @ballmac from the official registry directory, but the MCP server only reads the registries listed in components.json, so add it there:

pnpm dlx shadcn@latest registry add @ballmac=https://ui.ballmac.com/r/{name}.json

Connect your client

pnpm dlx shadcn@latest mcp init --client claude

Use --client cursor, --client vscode, --client codex or --client opencode for the others.

For Windsurf and other clients, add the server to your client's MCP configuration:

{
  "mcpServers": {
    "shadcn": {
      "command": "npx",
      "args": ["shadcn@latest", "mcp"]
    }
  }
}

What the agent sees

The shadcn MCP server exposes tools to list, search and view registry items, fetch examples, and get the add command. Each Ballmac item includes what an agent needs to pick it and wire it up. See Built for AI agents.