What can you do with this server?

This server lets AI coding agents discover, search, install, and manage Shadcn Space UI blocks, components, and full landing pages directly in a project. * Explore blocks & components: List all 14 block categories, free/pro blocks, components, and full pages. * Search: Find blocks and pages by keyword, category, tag, or free-only filter. * Install: Get official install commands, import paths, JSX examples, and style options (base/radix) for blocks and pages. * Manage installed items: List blocks and pages already installed in the project and inspect their files. * Get architecture guidance: Access landing page section sequence, container standards, spacing cadence, and customization limits. * Diagnose issues: Use self-healing error handling for license errors, missing config, and CLI failures. * Follow best practices: Use audit checklist for style, package manager, license, and navbar deduplication rules. * Use built-in prompts: Speed up work with prompts for building landing pages, adding hero/pricing/feature sections, creating UI, and searching.

shadcnspace-mcp

Official Model Context Protocol (MCP) server for Shadcn Space.

This MCP server allows AI-powered IDEs and coding agents (Cursor, Windsurf, Claude Desktop, Cline, Antigravity, etc.) to discover, search, install, and architect Shadcn Space UI blocks, landing pages, and components directly inside your project — with zero copy-pasting.

Quick Installation

Using the CLI

npx shadcnspace-cli install <client>

Supported Clients

cursor
windsurf
claude
cline
antigravity

Related MCP server: shadcn-vue-mcp

Manual Installation

Add to your IDE or client's MCP configuration (mcpServers):

{
  "mcpServers": {
    "shadcnspace-mcp": {
      "command": "npx",
      "args": ["-y", "shadcnspace-mcp@latest"]
    }
  }
}

For more details, visit our documentation: How to use MCP Server

Available Tools

The server provides 14 specialized tools callable via MCP:

Tool Name	Description
`listCategories`	Returns all 14 block categories (`hero`, `features`, `pricing`, `testimonials`, `faq`, `cta`, `header`, `footer`, `stats`, `forms`, `content`, `ecommerce`, `ai`, `widgets`) with live counts of total, free, and PRO blocks.
`listBlocks`	Lists blocks with license info (`isPro`). Supports filtering by `category` and license type (`all`, `free`, `pro`).
`listFreeBlocks`	Lists only 100% free Shadcn Space blocks that do not require any license. Supports optional category and keyword filters.
`listComponents`	Lists base components with search query and license filter (`all`, `free`, `pro`).
`getBlockInstall`	Returns official installation command, component export name, import path, JSX example, style options (base/radix), and license requirements for a specific block.
`searchBlocks`	Search blocks by keyword, category, and optional `freeOnly` filter.
`listInstalledBlocks`	Lists blocks currently installed in the user's project and gets their files.
`listPages`	Lists all Shadcn Space full pages.
`getPageInstall`	Returns official installation command, export name, import path, usage example, and style options for a specific full page.
`searchPages`	Search full pages using keywords or tags.
`listInstalledPages`	Lists pages currently installed in the project.
`getLandingPageGuidelines`	Comprehensive UI/UX landing page architecture: section sequence (Hero -> Logos -> Features -> Testimonials -> Pricing -> FAQ -> CTA -> Footer), container standards, and vertical spacing cadence.
`handleError`	Self-healing diagnostic tool for resolving license errors, missing `components.json`, component not found, and CLI installation failures.
`get_audit_checklist`	Mandatory workflow rules for AI agents: style check (base/radix), package manager detection, license handling, and navbar deduplication.

Note on Licensing: All pages and PRO blocks require a valid license key and email configured under registries in components.json. Free blocks can be installed directly without any license.

Available Prompts

The server provides 7 rich prompts to accelerate UI architecture:

Prompt / Command	Description
`build-landing-page`	Step-by-step guidance for an AI agent to architect and assemble a complete, high-converting landing page.
`add-hero-section`	Find, install, and integrate a high-impact hero block into an existing page.
`add-pricing-section`	Add a multi-tier pricing table with monthly/annual billing toggles.
`add-feature-grid`	Add a modern feature showcase or bento grid section.
`create-ui`	General prompt to architect a full UI page using Shadcn Space blocks.
`search`	Find specific UI blocks by topic or keyword.
`customization-guidelines`	Strict guidelines defining which parts of installed blocks can be safely customized (text only).

Testing & Debugging with MCP Inspector

You can interactively inspect, test, and debug all tools and prompts in your browser using the official MCP Inspector:

npm run inspector

Example Agent Usage

Once configured in your AI IDE, you can ask prompts like:

"Show me all free hero blocks available in Shadcn Space."

"Build a complete SaaS landing page for an AI productivity app using hero, bento features, testimonials, pricing, and FAQ."

"Give me the install command and import statement for pricing-01 in base style."

"What categories of blocks are available in Shadcn Space?"

Agent Instructions (Claude / Cursor / Windsurf)

To ensure your AI assistant follows official Shadcn Space best practices (checking Base vs Radix, package managers, and avoiding duplicate navbars), copy the system prompt in claude-instructions.md into your .cursorrules, .windsurfrules, or Claude Project Instructions.

License & Credits

Created by Shadcn Space.

MIT

Available Tools

5 tools

getBlockInstallGet Block Installation CommandA

Returns the official installation command for a specific Shadcn Space block. Agents can use this to add a block to the project automatically before customizing it.

Inputs: name (required).

listBlocksList All BlocksA

Provides a complete list of all Shadcn Space blocks that can be used in a project. Agents can use this to explore available block types before deciding which ones to add or customize.

Inputs: no named parameters.

listComponentsList All ComponentsA

Provides a full list of Shadcn Space components. Agents can use this to discover components to build pages or sections within a project.

Inputs: no named parameters.

listInstalledBlocksList Installed BlocksA

Lists all blocks that are currently installed in the project. Agents can use this to determine which blocks are available for customization or updating, and optionally filter by specific block names.

Inputs: names.

searchBlocksSearch Blocks by KeywordA

Search Shadcn Space blocks using keywords or tags. Agents can use this to find relevant blocks when building a page based on user requirements or content type.

Inputs: query (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

Deploy Server

Claude Code, inside the Godot 4 editorFlockbay puts an AI agent in the real Godot 4 editor: it writes GDScript, runs your game and fixes what breaks. Free, or bring your own Claude Code or Codex.flockbay.comAd

TDQS

A3.9/5.0

Scored 2026-04-27 08:10 across 5 tools

Disambiguation4/5

Tools have distinct purposes: listing all blocks, installed blocks, components, searching, and getting install commands. Slight potential confusion between listBlocks and listInstalledBlocks, but descriptions clarify the difference.

Naming Consistency4/5

All tools follow a verb+object pattern in camelCase (e.g., listBlocks, getBlockInstall). The pattern is consistent, though some names are multi-word (getBlockInstall) while others are two words (listBlocks).

Tool Count5/5

Five tools is well-scoped for a server focused on managing Shadcn Space blocks and components, providing essential discovery and installation information without being excessive.

Completeness4/5

Covers listing, searching, and install commands. Missing tools for adding/removing or customizing blocks, but the server's purpose appears informational, and agents can use the install command from getBlockInstall via shell.

Maintenance

ActivityNo data

ResponsivenessOutdated data

Resources

Related MCP Connectors

Wisty UIA
ai.wisty
Find, read and install shadcn components with Salesforce Lightning's look, for Radix and Base UI.
Design Tools Developer Tools
51
https://ui.wisty.ai/mcp
ReUI
io.github.keenthemes
Search, read and install ReUI shadcn components, examples, blocks and icons from your coding agent.
Developer Tools Design Tools Documentation Access
1
https://mcp.reui.io
DS Manager
com.shadcndesign.manager
Design System Manager for shadcn/ui: tokens, fonts, radius, components, icons, blocks, Figma sync.
Design Tools Developer Tools
1
https://manager.shadcndesign.com/api/mcp
Duck Framework MCPA
io.github.duckframework
Official Duck Framework MCP server for AI-assisted development and project scaffolding.
Developer Tools Coding Agents
13145
https://duckframework.com/mcp

Related MCP Servers

@jpisnice/shadcn-ui-mcp-server
Developer Tools Code Analysis Documentation Access
Jpisnice
A
license
A
quality
B
maintenance
A mcp server to allow LLMS gain context about shadcn ui component structure,usage and installation
Updated a month ago (2026-10-03 15:17 UTC)
10
7,100 npm
3,093
MIT
shadcn-vue-mcp
Developer Tools Autonomous Agents
HelloGGX
A
license
B
quality
D
maintenance
Shadcn-vue MCP Server is a powerful AI-driven tool that helps developers instantly create beautiful, modern UI components through natural language descriptions. It integrates the shadcn-vue component library and tailwindcss, seamlessly connects with mainstream IDEs, and provides a streamlined UI dev
Updated a year ago (2025-11-16 08:53 UTC)
5
511 npm
109
Apache 2.0
shadcn
Developer Tools Design Tools
dealenx
A
license
Not graded
quality
D
maintenance
This MCP server provides tools to install and manage shadcn/ui components directly from AI coding agents.
Updated 9 months ago (2026-02-22 23:18 UTC)
2
MIT
shadcn-registry-mcp
Developer Tools Coding Agents
Rachidhssin
A
license
A
quality
D
maintenance
A secure MCP server that gives AI coding assistants direct access to the shadcn/ui registry, enabling fetching, installing, and wiring up components without switching context.
Updated 8 months ago (2026-03-24 09:15 UTC)
8
19 npm
4
MIT

shadcnspace-mcp

Quick Installation

Using the CLI

Supported Clients

Manual Installation

Available Tools

Available Prompts

Testing & Debugging with MCP Inspector

Example Agent Usage

Agent Instructions (Claude / Cursor / Windsurf)

License & Credits

Available Tools

Tool Schema Changelog

TDQS

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

@jpisnice/shadcn-ui-mcp-server

shadcn-vue-mcp

shadcn

shadcn-registry-mcp