# Beste UI

> Beautiful, accessible blocks, pieces and components for shadcn/ui and Tailwind CSS, built for React and Next.js. Install one with the shadcn CLI and the code is yours to edit: no runtime dependency, nothing to upgrade.

Markdown rendition of https://ui.beste.co/docs/mcp. Every page on the site has one: add `.md` to any address, or send `Accept: text/markdown`.

Whole catalog for LLMs: https://ui.beste.co/llms.txt. Registry index: https://ui.beste.co/r/registry.json

---
Getting started

* [Introduction](/docs)
* [Installation](/docs/installation)
* [shadcn CLI](/docs/cli)

Customization

* [Theming](/docs/theming)

AI

* [MCP server](/docs/mcp)

About

* [Pricing & Pro](/docs/pricing)

Documentation menu

Getting started

* [Introduction](/docs)
* [Installation](/docs/installation)
* [shadcn CLI](/docs/cli)

Customization

* [Theming](/docs/theming)

AI

* [MCP server](/docs/mcp)

About

* [Pricing & Pro](/docs/pricing)

# MCP server

The shadcn block library your AI agent can actually use. Connect Beste UI to your editor, then ask for the UI you want in plain language: your agent searches the catalog, previews options, and installs the right block.

## Quick setup

Add the server to your MCP config. This works for free, with no account:

.mcp.json Copy

```
{
  "mcpServers": {
    "beste-ui": {
      "url": "https://ui.beste.co/api/mcp"
    }
  }
}
```

Using Claude Code? Add it with one command:

Terminal

![](https://oud.pics/sm/l/npm.svg)npm

$claude mcp add --transport http beste-ui https://ui.beste.co/api/mcp

 Unlock Pro block sources

To let your agent pull the source of Pro blocks, add your license to the endpoint URL. Everything else works without it. Find your email and license key on your [Account page](/account).

.mcp.json Copy

```
{
  "mcpServers": {
    "beste-ui": {
      "url": "https://ui.beste.co/api/mcp?email=you@example.com&license_key=YOUR_LICENSE_KEY"
    }
  }
}
```

## Available tools

| Tool               | Arguments                                    | License                 | What it does                                                                                                                                                                  |
| ------------------ | -------------------------------------------- | ----------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| search\_blocks     | query, type?, category?, collection?, limit? | Open                    | Semantic + keyword search across the whole catalog. Returns ranked matches with name, title, category, Pro status, and URL.                                                   |
| get\_block         | name, type?, flavor?                         | Open                    | Metadata for one asset: description, category, preview URL, and the shadcn install command.                                                                                   |
| get\_block\_source | name, type?, flavor?                         | License for Pro sources | The full .tsx source. Free items return immediately; Pro blocks require a valid license.                                                                                      |
| list\_categories   | —                                            | Open                    | Every category with its title and description.                                                                                                                                |
| list\_collections  | —                                            | Open                    | The studio collections: sets of blocks that share one design language, with a slug to pass to search\_blocks or compose\_page.                                                |
| install\_block     | name, type?, flavor?                         | Open                    | The exact shadcn CLI command to drop an asset into a project.                                                                                                                 |
| compose\_page      | intent, collection?, limit?                  | Open                    | Give it a page intent ('AI SaaS landing page') and it returns an ordered set of blocks that compose a full page. Name a collection and every section comes from that one set. |

## Try asking

* “Add a pricing section with three tiers and a monthly/yearly toggle.”
* “Find a hero with a product screenshot and a waitlist form.”
* “Compose a landing page for a developer CLI tool.”
* “Swap this testimonials block for a marquee of logos.”
* “Build me a page using blocks from the Sirius collection.”

## How it works

### Local semantic search

Every asset is embedded with a small open model. Queries match intent, not just keywords. No third-party AI service is in the path.

### Standard transport

Streamable HTTP MCP, so it drops into any compliant client with a single URL.

### Same license, everywhere

Pro sources use the exact license check as the CLI and site. Free assets are always open.

## Beste MCP vs. shadcn’s MCP

shadcn ships its own MCP server (`npx shadcn@latest mcp init --client claude`) that lets an agent browse, search, and install from any registries listed in your `components.json`. It is great, and Beste works with it too, since every Beste asset is a standard registry URL.

The Beste MCP server is a hosted layer on top of that with two things the generic path cannot give you: **semantic search** over the whole catalog (describe intent, not exact names) and **license-aware source**, where Pro blocks return their full source only to a valid license — the identical check used by the site and CLI. Use whichever fits; they are not mutually exclusive.

## Questions

Which AI tools does the MCP server work with?

Any MCP-capable client, including Claude Code, Cursor, Windsurf, and VS Code. It speaks the standard Streamable HTTP transport, so no custom plugin is needed.

Do I need a license to use it?

No. Searching, previews, metadata, install commands, and all free block sources work with no license. A Pro license is only required to pull the source of Pro blocks via get\_block\_source.

How does the semantic search work?

Every block, piece, and component is embedded locally with a small open model at build time. Queries are embedded the same way on the server, so search understands intent, not just keywords. There is no third-party AI service in the path.

[ PreviousTheming](/docs/theming)[Next Pricing & Pro](/docs/pricing)

## Ship the interface, keep the code.

New blocks, pieces and components every week. Install one with a command and it is yours to edit. No runtime dependency, no upgrade path to fight.

[Browse the libraryBrowse the library](/blocks)[See pricingSee pricing](/pricing)

### Library

* [Blocks](/blocks)
* [Pages](/pages)
* [Pieces](/pieces)
* [Components](/components)
* [Search](/search)

### Learn

* [Docs](/docs)
* [AI & MCP](/docs/mcp)
* [Blog](/blog)
* [Free tools](/tools)
* [What's new?](/changelog)
* [Website Builder](https://beste.co)

### More

* [Pricing](/pricing)
* [Referrals](/referrals)
* [License](/license)
* [GitHub](https://github.com/beste-co/beste-ui)

### Shadcn Blocks

* [Shadcn Hero Blocks](/blocks/hero)
* [Shadcn Feature Blocks](/blocks/feature)
* [Shadcn Pricing Blocks](/blocks/pricing)
* [Shadcn CTA Blocks](/blocks/cta)
* [Shadcn FAQ Blocks](/blocks/faq)
* [Shadcn About Blocks](/blocks/about)
* [Shadcn Stats Blocks](/blocks/stats)
* [Shadcn Footer Blocks](/blocks/footer)
* [Shadcn Navigation Blocks](/blocks/navigation)
* [Shadcn Auth Blocks](/blocks/auth)
* [Shadcn Ecommerce Blocks](/blocks/ecommerce)
* [Shadcn Portfolio Blocks](/blocks/portfolio)
* [Shadcn Showcase Blocks](/blocks/showcase)
* [Shadcn Careers Blocks](/blocks/careers)
* [Shadcn Onboarding Blocks](/blocks/onboarding)
* [Shadcn Coming Soon Blocks](/blocks/coming-soon)
* [Shadcn Post Blocks](/blocks/post)
* [Shadcn Legal Blocks](/blocks/legal)
* [Shadcn Workflow Blocks](/blocks/workflow)
* [Shadcn News Blocks](/blocks/news)

© 2026, [Beste](https://beste.co). All rights reserved.