Lets a coding agent search, read, and install animated React components from the UI Beats catalogue.
Also known as nikhils4/ui-beats, mcp, @uibeats/mcp
- Stars
- 235
- Tools
- 4
- Downloads, 30 days
- —
- Latest version
- 0.1.3
- Last commit
- Aug 23, 2026
- License
- MIT
What is UI Beats MCP?
UI Beats lets a coding agent search, read, and install animated React components from the UI Beats catalogue. It exposes 4 tools, such as search_components, get_component, list_components.
Summary generated from the project's README
About UI Beats MCP server
Finding and integrating animated React components directly through a coding agent is what UI Beats enables. Developers using Claude Code, Cursor, Windsurf, or Claude Desktop can browse a component catalogue, inspect source code, and execute installation commands without ever leaving their development environment. The server functions as a cached client that pulls data from static JSON search indexes and Markdown documentation files.
Users interact with specific tools like search_components for plain-language queries, get_component to retrieve props tables and usage examples, and list_components to view categorized items. Once a component is selected, get_install_command provides the necessary shadcn command and npm packages required for setup. The system maintains an in-memory cache for ten minutes and keeps a stale copy as a fallback to handle brief network interruptions. You can also point the UIBEATS_URL variable to a local development server if you are working on a custom implementation.
What you can do with it
- 1Discovering specific UI elementsAn AI agent can find specific animations by searching for descriptions like a card that flips.
- 2Inspecting component implementationDevelopers can have an agent read the full source code and props of a component before writing any JSX.
- 3Automating component installationThe agent can retrieve and run the exact shadcn command needed to add a component to a project.
Written from the project's README. Every use case is checked against a quote from it.
How to install UI Beats MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall UI Beats MCP in Claude Code
$ claude mcp add mcp -- npx -y @uibeats/mcpInstall UI Beats MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@uibeats/mcp"
]
}
}
}Install UI Beats MCP in VS Code
.vscode/mcp.json
{
"servers": {
"mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@uibeats/mcp"
]
}
}
}Install UI Beats MCP in VS Code CLI
$ code --add-mcp '{"name":"mcp","type":"stdio","command":"npx","args":["-y","@uibeats/mcp"]}'Install UI Beats MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@uibeats/mcp"
]
}
}
}Install UI Beats MCP in Codex
$ codex mcp add mcp -- npx -y @uibeats/mcpInstall UI Beats MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.mcp] command = "npx" args = ["-y", "@uibeats/mcp"]
Install UI Beats MCP in Gemini CLI
$ gemini mcp add -s user mcp npx -- -y @uibeats/mcpInstall UI Beats MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@uibeats/mcp"
]
}
}
}Started by HostedMCP on 16 Nov 2026
We ran this command for @uibeats/mcp 0.1.3 in an isolated container with no network and no keys. It answered and listed 4 tools.
UI Beats MCP tools 4
Read from the server with tools/listsearch_componentsRead-onlySearch the UI Beats catalogue by intent or name, e.g. 'card that flips', 'number counting up', 'animated background', 'flip-card'. Returns ranked matches with their description, docs URL and install command. Call get_component afterwards to read the actual source and props.
get_componentRead-onlyFetch the complete documentation for one component: description, when to use it, the full props table, a runnable usage example and the entire source file. Read this before writing code that uses a UI Beats component.
list_componentsRead-onlyList every component in the catalogue, grouped by category. Use this to see what is available before searching.
get_install_commandRead-onlyReturn the exact shadcn CLI command that adds a component to the current project, along with the npm packages it pulls in. Run the returned command in the project root.
Configuration
UIBEATS_URL
Automated checks
Ran Nov 16, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablenikhils4/ui-beats is public and reachablegithub.com/nikhils4/ui-beats ↗Pass
- Package names this repository as its source@uibeats/mcp names nikhils4/ui-beats as sourcenpmjs.com/package/@uibeats/mcp ↗Pass
- Build provenance (Sigstore attestation)Sigstore attestation for @uibeats/mcpnpmjs.com/package/@uibeats/mcp/v/0.1.3#provenance ↗Pass
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-08-23github.com/nikhils4/ui-beats ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from @uibeats/mcpPass
- No critical advisory in the package or its dependencies99 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model4 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHub@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:
claude mcp add uibeats -- npx -y @uibeats/mcp
Cursor, Windsurf, Claude Desktop and anything else that reads an
mcpServers block:
{
"mcpServers": {
"uibeats": {
"command": "npx",
"args": ["-y", "@uibeats/mcp"]
}
}
}
Tools
| Tool | What it does |
|---|---|
search_components |
Rank the catalogue against a plain-language query or a name |
get_component |
Full docs for one component: props table, usage example, complete source |
list_components |
Everything available, grouped by category |
get_install_command |
The 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
| Variable | Default | Purpose |
|---|---|---|
UIBEATS_URL |
https://uibeats.com |
Point at a local next dev while working |
UIBEATS_URL=http://localhost:3000 npx @uibeats/mcp
Development
This package is standalone: it is not part of the site's Yarn install.
cd packages/mcp
npm install
npm run build
License
MIT
UI Beats MCP questions
How do I add UI Beats MCP to Claude Code?
Run claude mcp add mcp -- npx -y @uibeats/mcp in your terminal. Add --scope user to make it available in every project.
How do I add UI Beats MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does UI Beats MCP provide?
It exposes 4 tools, including search_components, get_component, list_components, get_install_command.
How do I install the UI Beats MCP server for Claude Code?
Add it with the claude mcp add command, which runs the package via npx.
What tools does the UI Beats MCP server expose?
It provides search_components, get_component, list_components, and get_install_command.
Does the UI Beats MCP server need a backend or API key?
No. It is a cached client over two static files the site already publishes.
Can I point the MCP server at a local dev instance?
Yes, set the UIBEATS_URL environment variable to your local address.
How long does the MCP server cache the component catalogue?
The catalogue is cached in memory for ten minutes, with a stale copy kept as a fallback.