How do I use shadcndashboard-mcp?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@shadcndashboard-mcp List all available dashboard blocks" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

shadcndashboard-mcp

by shadcnspace

Overview Schema Source Related Servers Discussions Admin

TypeScript

Local

shadcndashboard-mcp

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

This MCP server allows AI-powered IDEs and agents to discover, search, and install Shadcn Dashboard UI blocks directly into your projects — with in-memory caching, token-efficient lightweight listings, upfront Free vs PRO discovery, layout composition blueprints, and automatic JSX code snippets.

Install MCP configuration

npx shadcndashboard-cli install <client>

Supported Clients

cursor
windsurf
claude
cline
antigravity

Related MCP server: aceternity-mcp

Manual Installation

Add to your IDE's MCP config:

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

For MCP, visit its MAIN PAGE
For more information visit our documentation on How to use MCP Server

Available Tools

The server provides the following tools callable via MCP:

Tool Name	Description
`get_audit_checklist`	Run first. Returns strict workflow rules, `components.json` pre-requisites, Free vs PRO rules, and shell layout requirements.
`listBlocks`	Lists all Shadcn Dashboard blocks with category (`shells`, `charts`, `metrics`, `tables`, `forms`, `layout`, `ai-ops`) and license tier (`free`, `pro`, `all`) filtering.
`listFreeBlocks`	Dedicated shortcut tool to list only 100% free blocks that require no license.
`listComponents`	Provides a lightweight list of Shadcn Dashboard UI components with optional tier filtering.
`getBlockInstall`	Returns the official installation command, component export name, import statement, and clean JSX usage snippet.
`searchBlocks`	Search blocks by keywords or tags with optional license tier filtering (`free`, `pro`, `all`).
`listInstalledBlocks`	Lists all blocks that are currently installed in the project.
`getDashboardLayoutGuidelines`	Get dashboard shell priority rules, domain composition recipes (AI Ops, SaaS, Ecommerce, Logistics, Healthcare), and CSS Grid / Flex alignment & height-balancing guidelines.
`handleError`	Intelligent error classifier and recovery guide for missing `components.json`, license, CLI, or not-found errors.

Available Prompts

The server provides rich prompts to guide AI agents through common workflows:

Prompt/Command	Description
`search`	Search for components or blocks by topic.
`create-ui`	Architect a full UI page using prebuilt dashboard shells and balanced grid layouts.
`build-dashboard`	Build a complete domain-specific dashboard (AI Ops, Ecommerce, SaaS/AI, Logistics, Restaurant POS, School, Healthcare).
`add-analytics-section`	Add a modern analytics & charts section with metrics cards to an existing page.
`create-auth-flow`	Generate authentication pages (login, signup, OTP, forgot-password, multi-step onboarding).
`create-data-view`	Create a data management view with filtering, search, and pagination.
`customization-guidelines`	Defines which parts of installed blocks can be safely modified (text only).

Example Usage

Once configured, your AI agent can perform tasks like:

"List all free dashboard shells" -> AI calls listFreeBlocks(category: "shells")

"Give me the installation command for dashboard-shell-01" -> AI calls getBlockInstall(name: "dashboard-shell-01", packageManager: "pnpm dlx") and gets the command + import snippet!

"Create a SaaS analytics dashboard layout" -> AI uses build-dashboard and follows getDashboardLayoutGuidelines

"Search for free chart blocks" -> AI calls searchBlocks(query: "chart", tier: "free")

Agent Instructions (Claude / Cursor / Windsurf)

If you are using Claude Projects, Cursor, or Windsurf, we have prepared a set of instructions you can copy-paste to make your AI use this MCP Server flawlessly. See claude-instructions.md.

Credits

Created by shadcndashboard.

MIT

Available Tools

6 tools

get_audit_checklistGet Agent Skills & InstructionsA

CRITICAL: You MUST execute this tool BEFORE using any other tools in this MCP server. Returns the strict workflow rules and guidelines for agents interacting with Shadcn Dashboard. Agents MUST read this first to understand how to handle free vs PRO components, package managers, and installation flows.

Inputs: no named parameters.

getBlockInstallGet Block Installation CommandA

Returns the official installation command for a specific Shadcn Dashboard 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 Dashboard 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 ComponentsB

Provides a full list of Shadcn Dashboard components. Agents can use this to discover components to build 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 Dashboard 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.5/5.0

Scored 2026-07-29 14:30 across 6 tools

Disambiguation4/5

Tools target distinct areas: blocks vs components, installed vs all, search vs list. Some slight overlap between listBlocks and searchBlocks, but descriptions clarify. get_audit_checklist is a prerequisite, not a functional overlap.

Naming Consistency2/5

Inconsistent naming: most use camelCase (getBlockInstall, searchBlocks, etc.) but get_audit_checklist uses snake_case. This breaks the pattern.

Tool Count4/5

6 tools for a dashboard block/component server is well-scoped: covers listing, searching, installing, and checking installed items. Not too many or too few.

Completeness3/5

Covers core discovery and installation but lacks tools for updating, removing, or getting details of specific components. The checklist tool is a unique prerequisite.

Maintenance

ActivityStale

ResponsivenessOutdated data

Resources

Related MCP Connectors

Server4AgentA
com.server4agent
MCP server that lets your AI assistant build and deploy apps, hosting each one at a live URL.
App Automation Cloud Platforms Developer Tools
343
https://mcp.server4agent.com
ClawLink
dev.claw-link
MCP server connecting AI agents to 100+ apps (Gmail, Slack, Notion, GitHub) via one-click OAuth.
App Automation Workplace & Productivity
24
https://claw-link.dev/api/mcp
Figma MCP Server
com.figma.mcp
The Figma MCP server brings Figma design context directly into your AI workflow.
Developer Tools Content Management Systems
32,182
https://mcp.figma.com/mcp
StackmarkA
dev.stackmark
Search a directory of 70K+ AI building blocks: MCP servers, agents, models, datasets, prompts.
Search AI & Machine Learning
41
https://stackmark.dev/mcp

Related MCP Servers

Shadcn UI MCP Server
Developer Tools Content Management Systems
heilgar
A
license
C
quality
D
maintenance
A Model Control Protocol server that allows users to discover, install, and manage Shadcn UI components and blocks through natural language interactions in compatible AI tools.
Updated a year ago (2025-05-21 16:34 UTC)
6
304 npm
27
MIT
aceternity-mcp
Developer Tools Design Tools
dvnold
A
license
A
quality
A
maintenance
MCP server for Aceternity UI components, enabling AI assistants to discover, search, install, and generate page layouts with 106 components.
Updated 6 months ago (2026-05-13 21:41 UTC)
12
1
MIT
aceternityui-mcp
Developer Tools Design Tools
rudra016
A
license
A
quality
D
maintenance
An MCP server that enables AI assistants to search, discover, and install Aceternity UI components programmatically.
Updated a year ago (2025-07-19 07:39 UTC)
5
170 npm
26
MIT
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

shadcndashboard-mcp

Install MCP configuration

Supported Clients

Manual Installation

Available Tools

Available Prompts

Example Usage

Agent Instructions (Claude / Cursor / Windsurf)

Credits

Available Tools

Tool Schema Changelog

TDQS

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

Shadcn UI MCP Server

aceternity-mcp

aceternityui-mcp

shadcn