What is Shadcn Space MCP?
Shadcn Space MCP is the official server for Shadcn Space UI blocks, pages and components. Its 14 tools let an AI coding agent search blocks by category and license, return exact install commands and imports, and follow built in guidelines for assembling a landing page.
Shadcn Space MCP is the official Model Context Protocol server for Shadcn Space. It lets AI-powered IDEs and coding agents discover, search, install and architect Shadcn Space blocks, landing pages and components directly in your project, without copy and paste.
Fourteen block categories sit behind it, from hero, features and pricing to ecommerce, ai and widgets. The server reports live counts of total, free and PRO blocks, so the agent knows what it may install before it tries.
What changes in your agent's output
- The agent asks for a real install command, export name and import path instead of inventing a component path.
- Style options for base or radix are returned with each block, so the install matches the project.
- Landing pages follow one section order: Hero, Logos, Features, Testimonials, Pricing, FAQ, CTA, Footer.
- Customization stays inside the rules. Installed blocks may be changed in text only, according to the bundled guideline prompt.
Free and PRO blocks
Free blocks install without any license. All pages and PRO blocks need a valid license key and email set under registries in components.json. The listFreeBlocks tool returns only blocks that need no license, which avoids failed installs.
Who Shadcn Space MCP is for
Best for
- Teams building marketing pages with shadcn components who want an agent to pick and install sections instead of drafting them.
- Readers comparing sources of blocks: the shadcn MCP page and Starwind UI serve other component libraries.
- Anyone pairing generation with a landing page design skill for copy and layout decisions.
Not for
- Projects that do not use shadcn style components, since every tool is built around Shadcn Space blocks.
- Teams that need free access to everything. Pages and PRO blocks require a license key.
- Designers who want a Figma reader. This server installs code blocks and does not read designs.
Use it with UiChemy
Shadcn Space blocks produce a coded front end. If the destination is a WordPress site, UiChemy fits there: Figma to WordPress converts designs, and Composer edits the page in Elementor or Gutenberg. Click Get Started on uichemy.com.
Connect Shadcn Space MCP: Search and Install UI Blocks from Your Editor to your AI client
npx shadcnspace-cli install <client>Install through the CLI
Run npx shadcnspace-cli install followed by your client. Supported clients are cursor, windsurf, claude, cline and antigravity.
Or add the entry by hand
Paste the mcpServers entry above into your client's MCP configuration. It runs shadcnspace-mcp@latest through npx.
Add a license if needed
For PRO blocks and pages, set your license key and email under registries in components.json. Free blocks need nothing.
Add the agent instructions
Copy the system prompt from claude-instructions.md in the repository into .cursorrules, .windsurfrules or your Claude Project Instructions.
Verify it
Ask for all free hero blocks, or for the install command and import statement for pricing-01 in base style. The agent should answer from tool results.
Client configuration
{
"mcpServers": {
"shadcnspace-mcp": {
"command": "npx",
"args": ["-y", "shadcnspace-mcp@latest"]
}
}
}Endpoints and ports
shadcnspace.comHow to use the MCP servernpm run inspectorTest tools and prompts in a browserWhat you can do with it
- Category browsingFourteen categories with live counts of total, free and PRO blocks help an agent choose a section.
- License aware searchFilters for all, free and pro keep the agent from proposing blocks your key cannot install.
- Exact install detailsInstall command, import path, JSX example and base or radix options come from the server, not guesswork.
- Full pagesPage tools list and search full pages, and list the pages already installed. getPageInstall returns the install command, export name, import path and usage example for a page.
- Seven promptsPrompts such as build-landing-page, add-hero-section, add-pricing-section and add-feature-grid guide common jobs.
- Self healing errorshandleError diagnoses license errors, a missing components.json and failed CLI installs.
- Customization limitsThe customization-guidelines prompt defines that only text should change in installed blocks.
- Inspector supportRun npm run inspector to test every tool and prompt in the browser before connecting an agent.
Tools it exposes
listCategories
Returns all 14 block categories with live counts of total, free and PRO blocks.
listBlocks
Lists blocks with license info, filtered by category and license type.
listFreeBlocks
Lists only free blocks that need no license, with optional category and keyword filters.
listComponents
Lists base components with a search query and license filter.
getBlockInstall
Returns the install command, export name, import path, JSX example, style options and license needs for a block.
searchBlocks
Searches blocks by keyword, category and an optional free only filter.
listInstalledBlocks
Lists blocks already installed in the project and gets their files.
listPages
Lists all full pages.
getPageInstall
Returns install command, export name, import path, usage example and style options for a page.
searchPages
Searches full pages by keywords or tags.
listInstalledPages
Lists pages currently installed in the project.
getLandingPageGuidelines
Returns landing page architecture: section sequence, container standards and vertical spacing.
handleError
Self healing diagnostics for license errors, missing components.json, component not found and CLI install failures.
get_audit_checklist
Workflow rules for agents: style check, package manager detection, license handling and navbar deduplication.
Frequently asked questions
What is Shadcn Space MCP?
It is the official Model Context Protocol server for Shadcn Space. It exposes 14 tools and 7 prompts so an AI coding agent can find, install and arrange Shadcn Space UI blocks, pages and components inside your project instead of copying code by hand.
How do I install Shadcn Space MCP?
Run npx shadcnspace-cli install with your client name, such as cursor or windsurf. You can also add an mcpServers entry that runs npx -y shadcnspace-mcp@latest, then check that your client lists the shadcnspace-mcp server.
Does it need a license key?
Free blocks install directly with no license. All pages and PRO blocks need a valid license key and email configured under registries in components.json. Use listFreeBlocks if you only want blocks that need no license.
Which clients does it support?
The CLI lists cursor, windsurf, claude, cline and antigravity. The README also names Claude Desktop among the supported AI IDEs and agents. For any other client, check its own MCP settings, since the README only spells out the clients it names.
What are the seven prompts?
They are build-landing-page, add-hero-section, add-pricing-section, add-feature-grid, create-ui, search and customization-guidelines. The README describes build-landing-page as step by step guidance for assembling a landing page, and add-pricing-section as adding a multi-tier pricing table with billing toggles.
What does handleError do?
It is a self healing diagnostic tool. The README lists four cases it helps resolve: license errors, a missing components.json, a component that cannot be found and CLI installation failures. It is one of the 14 tools the server exposes.
Is Shadcn Space MCP open source?
Yes. The repository is MIT licensed and created by Shadcn Space. It had its last push on September 21, 2026. The blocks it installs follow their own license rules, so free and PRO labels still apply to what you add.