Skip to content

shadcn/ui answers in Perplexity

Add the connector and Perplexity answers UI questions from the registry, with a component's props, a demo and the install, rather than from blog posts. It's part of shadcn.io Pro.

Kind
App
Goes in
Settings → Connectors
Connects
Through mcp-remote
Team config
No

Add it to the Mac app

Perplexity's Mac app runs the server through mcp-remote, a small bridge from npm. With Pro, the JSON beside these steps is already filled in with your URL.

  1. Copy the JSON

    It starts npx -y mcp-remote with your MCP URL, token included. No token yet? Create one on your account.

  2. Install Node.js and PerplexityXPC

    npx ships with Node.js (brew install node is one way). Perplexity also asks you to install its helper app, PerplexityXPC, before it lets you add a local connector.

  3. Add a custom connector

    Open Plugins in the sidebar (Customize → Connectors if you don't have Plugins yet), choose Add custom and add an MCP connector. On the Advanced tab, enter shadcnio as the Server Name, paste the JSON and select Save.

  4. Wait for Running, then turn it on

    Open it under Plugins → Installed and wait for Running. Then, in a new thread, open Sources and switch shadcnio on.

Settings → Connectors
Sign in to get your config
Sign in with a Pro account, and this holds your MCP URL, ready to paste.

How it reads, with YOUR_TOKEN where your token goes:

{
  "args": [
    "-y",
    "mcp-remote",
    "https://www.shadcn.io/api/mcp?token=YOUR_TOKEN"
  ],
  "command": "npx",
  "env": {}
}

Perplexity keeps the connector in the app, with no file to commit, and the token travels only from your Mac to shadcn.io. Treat it as a key: regenerate it if it leaks.

The ways into Perplexity, and who can use each
RouteWho can use itWhat goes in
Local connector, Advanced tabThe Mac app, with Node.js and PerplexityXPCThe JSON beside these steps
Remote connector (opens in a new tab)Perplexity Pro, Max and Enterprise, no Node.jsYour MCP URL, authentication None
Enterprise memberOnce an admin allows custom connectors (off by default)A remote connector, with your own URL

Watch it reach Running

Perplexity lists connectors under Plugins → Installed, each with its state: a working shadcnio reads Running, with its tool count.

  1. Open Plugins → Installed (or Customize → Connectors) and find shadcnio.
  2. Wait for Running, with 22 tools available.
  3. In a new thread, open Sources and switch shadcnio on.
  4. Ask the prompt below and confirm the call: Perplexity runs whoami and answers with your account, your plan and the calls left this minute.
Prompt
use shadcnio: which account and plan am I connected with?

Three questions, asked in Perplexity

Each starts as a question in a thread, the way Perplexity gets used: the calls it makes, then what you get back. Switch the MCP off to see the same question answered from the web.

Your agent
  1. shadcn.io MCP connected · 22 tools
  2. You: Which component should I use for a tag picker where people choose several tags, in React?
  3. MCP call: search_components({ query: "multi select tags" })Returns: combobox, the closest match
  4. MCP call: get_component_api({ name: "combobox", prop: "multiple" })Returns: On the root: several picks, the value an array
  5. MCP call: get_component({ name: "combobox", include: ["install", "demo"], demo: "multiple" })Returns: npx shadcn add …/r/combobox.json, and the chips demo
  6. Agent step: Wrote the answer: why a combobox, the command, the demoReturns: One reply, nothing pieced together from the web
  7. Your agent: Use the Combobox with multiple: each tag shows as a chip, and the command below adds it to your app.

In your project

Combobox, multiple

  • Chips with remove buttons, typing to filter
  • The install for your React app, in one line

1 prompt → 3 MCP calls

Questions to ask it

A thread starts without your project, so each one names the server and the framework.

01
use shadcnio to compare combobox and select for picking several tags in a React app
02
use shadcnio to plan a landing page for a podcast hosting startup, with one install command for every section
03
use shadcnio to find a design system that looks like Stripe and list its colors and type
04
use shadcnio to give me a Vue file upload with every file I need to create
05
use shadcnio to find Lucide icons for a weather app: sun, rain, wind and snow
06
use shadcnio to show me kanban board blocks I could use in a Solid app
07
use shadcnio to explain which props position a Popover next to its trigger
08
use shadcnio to set up a new Astro project for shadcn components on Base UI

Getting more from it in Perplexity

Sources, confirmations, your profile and the bridge: the parts of Perplexity that decide how well the MCP answers.

  • Switch it on in Sources

    A connector only answers in threads where it's switched on: open Sources in the message box and turn shadcnio on. Leave Web on to mix in articles, or turn it off to answer from the registry alone.

  • Confirming a call is safe

    Perplexity asks before it runs a connector's tool, and you confirm in the thread. All 22 shadcnio tools only read the registry, so a yes never changes your files, your project or your account.

  • Put your stack in your profile

    A new thread knows nothing about your project. Your profile's instructions in Settings apply to every question, so write your stack there once, and that UI questions go to shadcnio.

    For questions about UI components, use the shadcnio connector. My stack: Next.js, React, Base UI, pnpm.
  • Give it the full path to npx

    Perplexity may not find npx when Node.js came from nvm or another version manager. Put the path that which npx prints in Terminal into command; with Homebrew on Apple silicon, it's usually this one.

    "command": "/opt/homebrew/bin/npx"
  • Or add it as a remote connector

    On Pro, Max or Enterprise, skip Node.js: Plugins → Add custom → Connector → Add MCP connector, choose Remote and fill in the form as below. Tick the acknowledgement, select Add, then its card to turn it on.

    Name:            shadcnio
    MCP Server URL:  YOUR_MCP_URL
    Authentication:  None
    Transport:       Streamable HTTP
  • Keep the token out of the URL

    The Advanced tab's env reaches mcp-remote, which fills ${AUTH_HEADER} in from it. Use your URL without ?token=, and the token travels as an Authorization header instead.

    {
      "args": [
        "-y",
        "mcp-remote",
        "https://…/api/mcp",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "command": "npx",
      "env": { "AUTH_HEADER": "Bearer YOUR_TOKEN" }
    }

When it won't answer

Most problems come down to the bridge, the token or the Sources switch. The troubleshooting guide has every client's fixes.

shadcnio never shows Running under Plugins → Installed.
Perplexity couldn't start the command. Run npx -y mcp-remote "YOUR_MCP_URL" in Terminal: if Node.js is missing or older than 18, install a current one; if it connects there, give the connector the full path to npx.
Tool calls come back with a 401.
The token in the connector's URL is missing, or older than your last regenerate. Copy the JSON from this page again and edit the connector, or delete shadcnio and add it back.
Tool calls come back with a 403.
A 403 says the token is real but the Pro plan on its account isn't active. Renew from pricing and leave the connector as it is.
It shows Running, yet the answer cites web pages and never calls shadcnio.
Switch it on under Sources in that thread, and make sure no Web-only, Academic or Social filter is set. Then name it: use shadcnio to….
There's no way to add a local connector.
Local connectors need the Mac app with PerplexityXPC installed; update the app if the option is missing. On Windows or the web, add shadcnio as a remote connector (opens in a new tab) instead.
Your Enterprise account can't add custom connectors.
Admins decide: Allow members to add custom connectors, in Enterprise settings, is off by default. Ask for it, so each person's connector keeps their own token.

Get the MCP for Perplexity 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 Perplexity: setup, limits, and the rest.

4.9 out of 5 from 150+ developers

Ask Perplexity, get the real component

Every component, 6,231 blocks and 294k icons behind one Perplexity connector, with any shadcn.io Pro plan.

Get Pro