KokonutUI works out of the box with the shadcn MCP server. Once configured, your AI assistant can list every KokonutUI component, read its dependencies, and install it into your project — no manual CLI commands needed.

"Add @kokonutui/particle-button to my project"

1. Add the KokonutUI registry

The MCP server discovers registries through your components.json. Make sure the @kokonutui namespace is configured — see the installation guide if you haven't set it up yet:

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

2. Set up the MCP server

The fastest way is the mcp init command, which configures the server for your client automatically:

bunx --bun shadcn@latest mcp init --client claude

Use --client claude, --client cursor, --client vscode, or --client codex depending on your editor.

You can also configure it manually:

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

For Cursor, enable the server in Settings → MCP after adding the file. For VS Code, click Start next to the server entry in .vscode/mcp.json.

3. Use it

Restart your editor or MCP client, then ask in plain language:

"Show me all available components in the @kokonutui registry"

"Add @kokonutui/ai-prompt to my project"

"Build a pricing section using @kokonutui components"

The assistant resolves each component's registryDependencies (shadcn/ui primitives like button or textarea) and npm dependencies (like motion or lucide-react) automatically, exactly like the CLI does.