Docs

Use Ballmac UI from your AI agent

Ballmac UI works with the official shadcn MCP server, so your agent can list, search and view components, read their examples, and get the exact install command. No extra accounts or keys.

1. Add the registry

components.json

{
  "registries": {
    "@ballmac": "https://ui.ballmac.com/r/{name}.json"
  }
}

2. Connect your client

Claude Code

npx shadcn@latest mcp init --client claude

Cursor

npx shadcn@latest mcp init --client cursor

VS Code

npx shadcn@latest mcp init --client vscode

Codex

npx shadcn@latest mcp init --client codex

3. Ask for components

“Show me the Ballmac UI components for AI chat interfaces”
“Add @ballmac/button and @ballmac/number-ticker, then build a stats section with them”
“Which Ballmac UI component should I use for a live KPI, and how do I install it?”