UI Beats

com.uibeatsPublished by uibeats.comv0.1.3Updated Oct 24, 2026

MCP server for UI Beats. Let your coding agent search, read and install animated React components.

VerifiedSTDIODesktop onlyDeveloper ToolsMedia & Design

Overview

AI-generated overview

Local MCP server that lets a coding agent search, read and install animated React components from the UI Beats catalogue.

What you can do
  • Search the component catalogue by plain-language query or name, or list everything grouped by category
  • Read one component's full docs: props table, usage example and complete source
  • Get the exact shadcn install command and the npm packages it pulls in
When to use it
Useful when a coding agent is building React interfaces and should pick real animated components from the UI Beats catalogue, read their actual props before writing JSX, and install them without opening the website.
Requirements
Runs locally over stdio, typically via npx with the @uibeats/mcp package, so Node.js and network access to the UI Beats site are needed. No account, API key or header is declared. The optional UIBEATS_URL variable overrides the base URL, for example to point at a local dev server.
Before you install
The agent can run the shadcn install command it retrieves, which adds npm packages and writes component files into the project. Catalogue data is fetched from the UI Beats site and cached in memory, so queries and component requests go to that third party. Desktop-only; no web execution.

Installation

In SourceWeft

  1. Open UI Beats in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

@uibeats/mcp

MCP server for UI Beats. Lets a coding agent search the component catalogue, read a component's full source and props, and install it, without anyone opening the website.

Install

Claude Code:

bash
claude mcp add uibeats -- npx -y @uibeats/mcp

Cursor, Windsurf, Claude Desktop and anything else that reads an mcpServers block:

json
{  "mcpServers": {    "uibeats": {      "command": "npx",      "args": ["-y", "@uibeats/mcp"]    }  }}

Tools

ToolWhat it does
search_componentsRank the catalogue against a plain-language query or a name
get_componentFull docs for one component: props table, usage example, complete source
list_componentsEverything available, grouped by category
get_install_commandThe exact shadcn command, plus the npm packages it pulls in

A typical exchange: the agent calls search_components("card that flips"), then get_component("flip-card") to read the real props before writing any JSX, then get_install_command("flip-card") and runs it.

How it works

There is no backend. The server is a cached client over two static files the site already publishes:

  • /r/components.json: the search index (names, descriptions, props, guidance)
  • /docs/<category>/<name>.md: the canonical document for one component

The catalogue is cached in memory for ten minutes, and a stale copy is kept as a fallback so a brief network failure does not break every tool call.

Configuration

VariableDefaultPurpose
UIBEATS_URLhttps://uibeats.comPoint at a local next dev while working
bash
UIBEATS_URL=http://localhost:3000 npx @uibeats/mcp

Development

This package is standalone: it is not part of the site's Yarn install.

bash
cd packages/mcpnpm installnpm run build

License

MIT

Source: packages/mcp/README.md at commit e1c367a

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.3LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts