MCP.Market

Ballmac MCP server

by vamsiy78·io.github.vamsiy78/ballmac·v1.0.3·7 stars
No reviews yet

Search, inspect and install Ballmac UI React and Tailwind components, blocks and templates.

A92/100grade A
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
A92/100

full report

Adoption
Growing

7 stars760 downloads/wk

Reviews

Write one

Nobody has reviewed Ballmac yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Ballmac tools (8)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • compose_page

    Plan a page from Ballmac UI blocks for an intent such as 'SaaS landing page with pricing and FAQ' or 'login screen'. Returns the chosen blocks in page order, install commands, a page.tsx scaffold that renders them, and any complete templates that already fit the intent.

  • get_examples

    Working example code for an item (the same examples shown on its page).

  • get_install_command

    The shadcn CLI commands to add one or more items to the user's project. `setup` is optional: a current shadcn CLI resolves @ballmac without it, so run it only for an older CLI. Then run `add`. `byUrl` works without setup for free items. Pro items install as @ballmac-pro/<name> and need `proSetup` once.

  • get_item

    Everything about one item: description, when to use and not, import line, props, keyboard behaviour, dependencies, composition hints, template pages and the full source (for Pro items only when the server has BALLMAC_LICENSE_KEY; see the `licence` field). Set includeSource to false for a shorter answer.

  • get_setup

    How to prepare a project for Ballmac UI (shadcn init, optional theme, and the registry entry older CLIs need) and its requirements.

  • list_categories

    How many components, blocks and templates there are, and the categories each is grouped into, with counts. Use the names as the category filter of list_items.

  • list_items

    List components, blocks or templates, optionally filtered by kind, category (a component category such as primitives, motion or ai; a block section such as hero or pricing; or a template kind such as marketing) or tier. Call list_categories for the valid names.

  • search_items

    Search by what the user needs (for example 'chat input with attachments', 'animated stat', 'pricing section', 'online store'). Understands common synonyms such as modal, navbar or ecommerce. Returns the best matches with when-to-use guidance.

Public scan report

scanner v0.1.10 · 2026-10-13 · same rubric, same numbers if you re-run it

no findings
  • Code scan3 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitylocal package, no credentials required12/15
  • Maintenancelast push 1 days ago15/15
  • Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Overall 92/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How Ballmac compares

Against every graded Web search MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
92/100
higher than 90% of 3,470 Web search servers
Tools
8
the typical Web search server has 5
Tools that change things
0%
typical: 0%. Fewer write tools means less an agent can break
GitHub stars
7
more than 83% of 1,786 Web search servers
Downloads a week
760
more than 92% of 827 Web search servers with a package

What its tools let an agent do: 8 read

Install Ballmac in Claude Code, Cursor or VS Code

Runs npx -y @ballmac/mcp on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add ballmac -- npx -y @ballmac/mcp
Add to Cursor

What the publisher says

From the Ballmac repository's README, as published. We do not edit it. Read it on GitHub

Ballmac UI

Accessible React + Tailwind v4 components, blocks and templates in one design language. You add what you need with the shadcn CLI and the source lands in your project, ready to read and change. Your AI coding agent can search and install them too, through MCP. Now listed in the official shadcn registry directory.

Site and docs: ui.ballmac.com

What is in it

tools, device frames and desktop-style surfaces.

  • 240+ components: primitives, forms, data display, navigation, feedback, motion, backgrounds, text effects, AI interfaces, developer

provider for its built-in text. See AUTHORING.md.

  • 60+ blocks and 17 templates: heroes, pricing, dashboards, sign-in, settings and more, composed from the components.
  • 12 themes with a live builder, light and dark. Motion is part of the theme: speed, bounce, travel, hover and stagger, five ready-made feels, and a reduced-motion fallback. Data and form blocks show loading, empty, error, submitting and success through one state prop. Platform feels make every component handle like macOS, iOS or Windows, with window chrome for Tauri and Electron apps.
  • Built to a standard: every item has examples, keyboard support, reduced-motion handling, right-to-left support and one translation

through llms.txt, a JSON API and the @ballmac/mcp server.

  • Made for AI agents: each item carries a description, when to use it and when not to, what it composes with, and keyboard notes. Available
  • No collisions: everything installs into components/ballmac/, so it never overwrites your shadcn/ui files.
  • Verified installs: the release check installs every item into a fresh Next.js app, then type-checks and builds it.

Quick start

You need a project with React 19, Tailwind CSS v4 and shadcn set up (npx shadcn@latest init; it creates components.json). Both the Base UI and Radix styles work.

# add components by name; npm dependencies are installed for you
npx shadcn@latest add @ballmac/button @ballmac/dock
import { Button } from "@/components/ballmac/button"

@ballmac is in the official shadcn registry directory, so there is no registry to configure. On an older CLI, or to pin the address, run npx shadcn@latest registry add "@ballmac=https://ui.ballmac.com/r/{name}.json" once, or install by URL: npx shadcn@latest add https://ui.ballmac.com/r/button.json. Browse and preview everything at ui.ballmac.com/components, and see the installation guide for the optional Ballmac theme.

Use it with an AI agent

claude mcp add ballmac -- npx -y @ballmac/mcp

The server is read-only and needs no account. It searches the catalog, returns props, keyboard behaviour and source, gives the exact install command, and can plan a whole page from blocks. Setup for Cursor, VS Code, Windsurf, Codex and Claude Desktop is in the MCP docs and in packages/mcp. The official shadcn MCP server also works with this registry.

Free and Pro

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Ballmac: common questions

Is Ballmac MCP server safe?
Yes, by our scan: it is graded A (92/100). Read the Ballmac safety report
How do I install Ballmac?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Ballmac need an API key?
Not as far as the registry entry and our scan can tell: no credentials are declared or required.
Is Ballmac maintained?
The last commit was 23 days ago (2026-10-12). The latest release is v1.0.3.
What can I use instead of Ballmac?
Servers from other publishers that do the same job: Watermelon UI MCP server, Qaskills MCP server and Chatroost — unofficial Telegram MCP server.
How does Ballmac compare with other Web search MCP servers?
safety score 92/100 (higher than 90% of 3,470 Web search servers); tools 8 (the typical Web search server has 5); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.

Alternatives to Ballmac

Same job from other publishers: the closest match first, then the best rated.

  • Watermelon UI
    Search free React, Tailwind, and shadcn components, blocks, and dashboards; get installable source.
    B
  • Qaskills
    Search, inspect, and install 400+ QA testing skills from qaskills.sh into any MCP client.
    A
  • Chatroost — unofficial Telegram MCP server
    Unofficial Telegram MCP server — read, search, reply and react in your own Telegram account.
    A
  • Keyline Icons
    Search Keyline Icons by name and get any icon's SVG source or React import. No key, no network.
    A
  • Apple Notes
    Inspect, search, create, edit, move, and organize notes in Apple Notes on macOS.
    More from JonathanRReed →
    A