shadcn/ui in your BoltAI chats
Add one entry to BoltAI's MCP config and any model with tool use can search components and blocks and hand you the install. You'll need shadcn.io Pro on top of your BoltAI license.
- Kind
- App
- Goes in
Plugins → MCP server config- Connects
- Through mcp-remote
- Team config
- No
- Its docs
- BoltAI MCP (opens in a new tab)
Add it to BoltAI's mcp.json
BoltAI runs local MCP servers from one JSON file, and this entry is one of them. Signed in with Pro, the config beside the steps carries your own URL.
Copy the entry
With Pro, the config holds your MCP URL, token included, as the last of
mcp-remote's arguments. No token yet? Create one on your account.Open Settings → MCP Servers
In BoltAI 2, add the
shadcnioentry insidemcpServersin~/.boltai/mcp.json, next to any servers already there. BoltAI 1 edits the same file from Settings → Plugins and its plus button.Start or reload shadcnio
The first start fetches
mcp-remotethroughnpx, so give it a moment. Once it runs, its 22 tools show as available on the same screen.Switch its tools on in a chat
In a new chat, check Tool Use is on, open Tools in the composer and enable
shadcnio: all 22 tools, or only the ones the task needs.
How it reads, with YOUR_TOKEN where your token goes:
{ "mcpServers": { "shadcnio": { "args": [ "-y", "mcp-remote", "https://www.shadcn.io/api/mcp?token=YOUR_TOKEN" ], "command": "npx" } } }
~/.boltai/mcp.json is local-only: BoltAI doesn't sync it to BoltAI Cloud or your other devices, so your token stays on this Mac. If it leaks, regenerate it.
| App | Where it goes | Then |
|---|---|---|
| BoltAI 2 for Mac | Settings → MCP Servers, saved in ~/.boltai/mcp.json | Start or reload it, then Tools in the composer |
| BoltAI 1 (1.34 or later) | Settings → Plugins, the plus button, Save Changes | Enable it in a chat's plugin dropdown |
| BoltAI on iPhone and iPad | Remote servers only: iOS can't start mcp-remote | Use it from the Mac |
See it running
Settings → MCP Servers lists each local server with its state: a running shadcnio shows its tools, and one that didn't come up shows a status such as Startup timeout instead.
- Open Settings → MCP Servers and find
shadcniorunning, its 22 tools listed. - Start a chat with a model that supports tool use, open Tools in the composer and switch
shadcnioon. - Send the prompt below: the model calls
whoami, and the reply names your account and your remaining calls for the minute.
Three chats, with the MCP and without
Two plain chats and one with a linked project folder: the prompt, every call, and what you get back. Flip the MCP off to see the same prompt answered from memory.
- shadcn.io MCP connected · 22 tools
MCP call: plan_page({ brief: "launch page for a Mac menu-bar app with a waitlist", framework: "react", kind: "marketing" })Returns: Hero, features, FAQ and CTA, each with two alternativesMCP call: get_block({ names: ["hero-centered-email-capture", "features-bento-grid", "faq-accordion", "cta-centered-dark-email-capture"], include: ["install"] })Returns: The four blocks' install, as one command to pasteAgent step: Wrote the section order and the command into the replyReturns: Four blocks, top to bottom, ready for Terminal
In your project
Launch page
- Four sections, in the order the plan picked
- One command to paste in your project's Terminal
1 prompt → 2 MCP calls
Prompts for a BoltAI chat
Copy one into a chat with shadcnio's tools on. Naming the server steers the model to it; with a linked folder, name the file too.
Make it work better in BoltAI
BoltAI's own controls, from tool picking to projects and agents, decide how the model uses shadcnio.
Pick tools, not the whole server
BoltAI 2 lets you enable single tools from a server. A quick component question needs only
search_componentsandget_component; a full page addsplan_pageandget_block. Fewer tools means less for the model to read on every request.Keep it to one project
Open the project in the sidebar and choose Manage Plugins in its header to turn on
shadcniothere and nowhere else. Give the project a default agent, and new chats start with its instructions, model and plugins.Link the project folder
Since 2.16, a project can link folders on your Mac (beta): the model reads
package.json, edits files once you approve, and readsAGENTS.mdorCLAUDE.mdfrom the folder. One line there makesshadcniothe default.Before writing UI, search the shadcnio MCP for a component or block and use the install it returns.An agent for UI work
Build an agent whose instructions send UI questions to
shadcnio, with its tools switched on. Since 2.18, a new chat's tools follow the agent you pick, so choosing it is the whole setup.Point it at npx
Local servers start from your shell's environment, and BoltAI 2 has no PATH field. If the server can't find
npx, setcommandto its absolute path; MCP Runtime ENV under Settings → MCP Servers controls which variables get passed.$ which npx # put the path it prints in "command", in place of npx
Long answers and step limits
A Vue or Svelte install plan can run long: BoltAI continues a reply that hits the output limit, up to three times (Settings → General). An agent run stops at its step limit, 30 by default, raised under Agent Loop Control in the chat's inspector.
When shadcnio won't answer
What BoltAI shows, and the fix. Its Console.app logs (opens in a new tab) have an MCP category, and the troubleshooting guide has the rest, for every client.
shadcnioshows Startup timeout in Settings → MCP Servers.- The first start downloads
mcp-remote, which can take longer than BoltAI waits. Reload the server once it's done; on a version before 2.12, update, since 2.12 fixed servers timing out at launch. - The server never starts, and the log says
npxcan't be found. - Install Node.js, which brings
npx, or setcommandto the pathwhich npxprints. BoltAI starts local servers from your shell's environment. shadcniostopped connecting after you made a new token.- The URL in
~/.boltai/mcp.jsonstill carries the old one, so the server answers 401. Copy the config from this page again, replace the entry and reloadshadcnio. - The MCP log shows 403 when
shadcniostarts. - Your token is valid, but the account has no active Pro plan. Renew it and reload the server: the entry itself doesn't change.
- Tools in the composer doesn't offer
shadcnio. - Check that it's running in Settings → MCP Servers and that Tool Use is on for the chat. A model without tool use, or a project or agent with its own tool list, can hide it too.
- The model answers from memory and never calls a tool.
- Its tools may be off in this chat: switch them on from Tools. Then name the server (
use shadcnio…), or put a line in the linked folder'sAGENTS.md.
Get the MCP for BoltAI with Pro
The MCP comes with every Pro plan, with every block and premium template, for you or your whole team. Monthly, yearly or lifetime.
4.9/5 out of 5 · 150+ reviewsfrom 150+ founders and developers.
- Secure checkout via Stripe
- Code lives in your repo
- Keep what you've shipped if you cancel
- License terms
Frequently asked questions
The shadcn MCP in BoltAI: setup, limits, and the rest.
In BoltAI 2, the shadcnio entry goes inside mcpServers in ~/.boltai/mcp.json, which Settings, MCP Servers edits for you. BoltAI 1 (1.34 or later) edits the same file from Settings, Plugins with the plus button and Save Changes.
Entries in mcp.json are commands BoltAI starts on your Mac. mcp-remote is a small bridge from npm that starts that way and forwards each call to your MCP URL. That keeps the server, and your token, in the local file that never syncs.
Copy ~/.boltai/mcp.json to the other Mac, or add the same entry there, then start the server from Settings, MCP Servers. Each Mac needs Node.js for npx.
Not with this entry. iOS can't start a local process, so the mobile app takes remote servers only, and mcp-remote runs locally. Use shadcnio from BoltAI on your Mac.
Any model with tool use, whichever provider it comes from. Check that Tool Use is on for the chat. If the composer's Tools menu offers nothing, the model you picked can't call tools, so switch to one that can.
Yes, if the local model supports tool use. The model stays on your Mac, but the shadcn MCP is a remote server, so each call still goes to shadcn.io with your token.
For React, the reply gives you one npx shadcn add command, your token in its URL, to run in Terminal. For Vue, Svelte and Solid it lists every file with its path. Since 2.16, a linked project folder (beta) lets the model edit your files once you approve.
BoltAI 2 lets you enable single tools from a server. A quick component question needs only search_components and get_component; a full page adds plan_page and get_block. Fewer tools means less for the model to read on every request.
Open the project in the sidebar and choose Manage Plugins in its header to turn shadcnio on there and nowhere else. Give the project a default agent, and new chats start with its instructions, model and plugins.
Whichever license you hold, the server needs a shadcn.io Pro plan on top: the tools answer only for a token whose account has Pro, monthly, yearly or lifetime. Add the entry, then ask for whoami in a chat to see which account and plan the connection uses.
Yes, but there's no shared file to commit: each person adds the entry with their own MCP URL, on their own Mac. A shadcn.io Team or Organization plan gives every member Pro, and with it a token of their own.
No. Local servers in ~/.boltai/mcp.json are local-only, so the entry and the token in its URL stay on this Mac.
Yes. All 22 only read from shadcn.io and can't change your Mac or your account. What changes a project is a command you run yourself, or a linked-file edit BoltAI asks you to approve.
The first start downloads mcp-remote, which can take longer than BoltAI waits. Reload the server once it's done; on a version before 2.12, update, since 2.12 fixed servers timing out at launch.
Install Node.js, which brings npx, or set command to the path that which npx prints. BoltAI starts local servers from your shell's environment and has no PATH field in version 2.
Check that the server is running in Settings, MCP Servers and that Tool Use is on for the chat. A model without tool use, or a project or agent with its own tool list, can hide it too.
401 means mcp.json still carries an old token, for example after you made a new one: copy the config again and reload shadcnio. 403 means the account has no active Pro plan; renew it and reload. 429 means that token passed 600 calls inside a minute, so give it a moment.
Using another agent too?
The same URL works in every MCP client: use it beside BoltAI, in your editor, your terminal or your chat app.
4.9 out of 5 from 150+ developers
Bring the registry into BoltAI
6,231 blocks, 294k icons and every component, for whichever model you chat with in BoltAI, in every Pro plan.
Get Pro