What is shadcn-svelte MCP?
shadcn-svelte MCP is a tmcp server that serves real time shadcn-svelte documentation to AI editors. It scrapes shadcn-svelte.com and bits-ui.com live, exposes five tools for components, search, icons and the Bits UI API, and caches results for three days in memory and on disk.
Built on tmcp, this server fetches shadcn-svelte.com and bits-ui.com on demand. The README's pitch is no stale docs: an agent reads what the sites show today, instead of a bundled snapshot that ages.
It covers shadcn-svelte components, blocks and charts, the low level Bits UI primitives, and more than 1,800 Lucide icons with import snippets. Search is intent aware, with typo tolerance and install snippets per package manager.
Hosted server shutting down
The README warns that the hosted endpoint is being turned off, because the maintainer pays for it personally. It recommends the local npx package, which runs the same server on your machine and needs Node 20.9 or newer.
Optional skill and agent
- A SvelteKit design skill lives at
skills/shadcn-sveltekit-design/SKILL.mdin the repository. - Ready made agent files cover VS Code, Claude Code, Cursor, Windsurf, OpenCode, Zed, Codex and Gemini CLI.
- Without the MCP, the agent says so and falls back to the official docs instead of guessing.
Who it suits
Best for
- SvelteKit projects using shadcn-svelte. Related: the shadcn MCP server.
- Agents that need exact Bits UI props, events and data attributes.
- Related: the community shadcn/ui server.
Not for
- React only projects. The docs it serves are for Svelte.
- Offline use before the first fetch, since content is scraped live and then cached for three days.
- Anyone expecting an HTTP endpoint to stay up. Self hosting on Fly.io or Render is the stated option.
Use it with UiChemy
This server helps an agent write Svelte UI. If the end goal is a WordPress site, UiChemy's AI to WordPress imports an AI build and Composer edits it inside Elementor or Gutenberg. Click Get Started on uichemy.com.
Connect shadcn-svelte MCP: Live Svelte Docs, Bits UI and Icons to your AI client
claude mcp add shadcn-svelte -- npx -y shadcn-svelte-mcpCheck Node
The README says Node 20.9 or newer is required. Bun users can swap npx for bunx.
Add the server
In Claude Code run the command above, or
codex mcp add shadcn-svelte -- npx -y shadcn-svelte-mcpfor Codex. Other editors take the JSON config.Keep the name shadcn-svelte
The shipped agent files bind tools as shadcn-svelte slash star, so the server name must match.
Verify
Run
claude mcp listorcodex mcp list, or use MCP: List Servers in VS Code, and confirm the server appears.
Client configuration
{
"mcpServers": {
"shadcn-svelte": { "command": "npx", "args": ["-y", "shadcn-svelte-mcp"] }
}
}Endpoints and ports
http://localhost:3000/mcpStarted with bun run dev, health at /healthhttps://github.com/Michael-Obele/shadcn-svelte-mcp/tree/main/agentsPer editor agent definitionsWhat you can do with it
- Live documentationDocs are scraped from shadcn-svelte.com and bits-ui.com at request time, not bundled.
- Intent aware searchConcept queries, categories and multi query search work with typo tolerance.
- Install snippetsEach result can include an install command for your package manager.
- Lucide icon lookupMore than 1,800 icons come with import snippets.
- Guided promptsFive prompts cover installing a component, theming, CLI usage, project init and which tool to use when.
- Three day cacheA memory and disk cache keeps repeat queries fast.
Tools it exposes
shadcn-svelte-get
Returns details and an install snippet for a known component, block or doc, with packageManager support.
shadcn-svelte-search
Searches by intent or keyword, with multi query and category options, when the exact name is unknown.
shadcn-svelte-list
Lists the full inventory of components, blocks, charts and docs.
shadcn-svelte-icons
Finds Lucide icons by name, with limit and importLimit options and import snippets.
bits-ui-get
Returns low level Bits UI API details such as props, events and data attributes.
Frequently asked questions
What is shadcn-svelte MCP?
It is an MCP server that gives AI editors live shadcn-svelte and Bits UI documentation, plus Lucide icons. It scrapes the official sites at request time, so an agent sees current docs instead of a stale bundled copy.
How do I install shadcn-svelte MCP?
Run claude mcp add shadcn-svelte -- npx -y shadcn-svelte-mcp, or add the same npx command to your editor's MCP config. The README recommends the local npm route and lists Node 20.9 or newer as a requirement.
Is the hosted endpoint still available?
The README says the hosted server at its svelte-apps.me address is shutting down, and recommends the local npx package instead. If you want an HTTP endpoint you can deploy the server yourself to Fly.io or Render.
Which tools does it provide?
Five tools: shadcn-svelte-get, shadcn-svelte-search, shadcn-svelte-list, shadcn-svelte-icons and bits-ui-get. The README suggests starting with get, falling back to search, and using bits-ui-get only when you need primitive internals and props today.
Which AI coding agents does it work with?
The README gives setup for Claude Code, Codex, Cursor, Windsurf, Zed, VS Code and Gemini CLI. It also ships agent files per editor, including OpenCode, so the same workflow applies across them.
How is it different from the shadcn MCP server?
This one targets shadcn-svelte and Bits UI for Svelte projects, and serves scraped docs. Without the MCP, the agent says so and falls back to official shadcn-svelte docs instead of guessing. Pick by the framework in your project. Related: shadcn MCP server.
What license does it use?
The repository is MIT licensed. Contributing guidance and a code of conduct are included in the repository, and the maintainer accepts sponsorship through GitHub Sponsors for those who want to support the work.