MCP

The shadcn MCP Server lets AI assistants browse, search, and install registry items with natural language.

MCP Server

After configuring your registries in components.json, you can prompt your assistant with requests like:

• Find me a header from @diarmuradi
• Add a pricing block from @diarmuradi
• Install header-7 from @diarmuradi-pro
• Build a landing page using @diarmuradi blocks

Quick setup

Run the following in your project:

pnpm
npm
yarn
bun
Copy
pnpm dlx shadcn@latest mcp init --client cursor

Replace cursor with your client: claude, vscode, codex, or opencode.

For full options, see the shadcn MCP documentation.

Guidelines

• Match your components.json style to your UI base: base-* for Base UI (default), radix-* for Radix UI, or aria-* for React Aria
• Keep REGISTRY_TOKEN out of source control
• Copy install commands from the site. Don't guess registry item names
• Use @diarmuradi for free samples and @diarmuradi-pro for gated blocks
• Run npx shadcn@latest view @diarmuradi/{name} before adding unfamiliar items

Next steps

• Quick Setup
• Project setup
• Registry