Ply UI
OfficialThis MCP server exposes the Ply UI Angular + Tailwind component registry and the ply-ui-cli workflows: browse and inspect components, then install, diff, update, and verify them in a local project.
list_components — browse the registry filtered by tier (
free/pro/all), category (component, block, widget, page-layout, shell, application) or a case-insensitive substring; sorted by name.search_components — fuzzy/token-ranked lookup when the component name is uncertain (e.g. "dialog modal"), with
limit1–40 plus tier/category filters.get_component — metadata for one known component (dependencies, category, file list), optionally including free-tier source; Pro source is never streamed.
add_components — install named components into a project that already has
ply-ui.json, with optionaloverwrite; Pro names needPLY_LICENSE_KEY. ReturnsmissingPackagesand aninstallCommand.init_project — create missing setup files (ply-ui.json, ply-ui.css, icon sprites,
@source, editor rules/snippets and design skill); non-interactive, existing files kept unlessrefreshEditorKit.doctor — read-only verification of ply-ui.json, Angular/CDK, Tailwind v4
@source, ply-ui.css, and icon sprites, with structuredchecks.diff_components — read-only comparison of tracked component files against the registry, reporting drift statuses.
update_components — apply upstream changes, with
force, 3-waymerge, andoverwriteLocaloptions; per-file results.
Note: catalog tools never install anything — copying code requires add_components, init_project, or the CLI.
Installs Ply's Angular component library into an existing Angular project: initializes the project (ply-ui.json, ply-ui.css, icon sprites, design skill), adds standalone signal-based, zoneless, SSR-safe components and form blocks by name with recursive dependency resolution, and diffs/updates tracked component copies against the registry. Also inspects component metadata and free-tier source so agents can work with the copied-in Angular source directly.
Sets up and validates Tailwind CSS 4 for a Ply project — checks that Tailwind v4 and PostCSS are configured, that the stylesheet is registered in angular.json, and that @source paths cover the templates — and wires Ply theme tokens (--ply-brand, --ply-primary, brand scale) so component styling follows the project's theme.
This server has a remotely hosted endpoint. Open its connector listing for connection details, authentication requirements, and setup instructions:
MIT free-tier source. Components live in
components/(same layout asnpx ply-ui-cli add). CLI and MCP live inpackages/. Pro items are not stored here — install those withPLY_LICENSE_KEYfrom ply-ui.com.Angular 19+: free components on
compat/angular-19.mainis Angular 22 (signal-forms[formField]).
Ply — Angular + Tailwind Component Library
Ply (formerly Base UI (Angular)) — ply-ui.com — is a CLI-first Angular + Tailwind CSS component library: 229 components and blocks (128 free, 101 Pro), 392 outline icons (filled: star and heart), and 18 full page layouts — standalone, zoneless, signal-based and SSR-safe, delivered shadcn-style: npx ply-ui-cli add copies the source into your project and it's yours. Not MUI Base UI (React).
📚 Documentation & live previews: ply-ui.com
📝 Changelog: ply-ui.com/changelog · CHANGELOG.md · Issues · Discussions
♿ Accessibility (ACR): ply-ui.com/accessibility · npm run test:a11y
🖥️ SSR-safe: the docs site prerenders every catalog route, enforced by a blocking CI job · how we verify it
🤖 AI agents (MCP): ply-ui.com/getting-started#ai-agents-mcp · ply-ui-mcp · why copy-in UI works better with LLMs · token walkthrough: rich text editor · design skill on init
🎨 Figma Design System: Ply Design System
✨ See what you can build for free: Live Admin Dashboard Demo (Source code: ply-free-dashboard)
🚀 Quick Start (Free Tier)
The free tier is production-ready with no account or license: all primitives (buttons, cards, dialogs, hover cards, menubars, inputs, currency fields, selects, tabs, stacked toasts, tooltips, and more) plus all 19 form blocks (login, signup, checkout, billing, wizard, …).
1. Initialize your project
npx ply-ui-cli initThis writes ply-ui.json, creates ply-ui.css (CDK overlay styles, keyframes, autofill fixes) imported from your global stylesheet, and downloads the icon sprites into your assets folder. Use --yes to accept defaults non-interactively. It does not install npm packages, so add the Angular CDK yourself: npm install @angular/cdk.
2. Configure Tailwind CSS
Ply works with standard Tailwind CSS 4 — no custom theme file required.
Install Tailwind CSS 4 and PostCSS (Angular guide).
Create
src/tailwind.css, register it inangular.jsonbefore global SCSS, and point@sourceat your templates.@sourcepaths are relative to the CSS file:
@import "tailwindcss";
@source "./**/*.{html,ts}";Buttons, inputs, folder/underline/pills tabs, selects, combobox, toast, accordion, and the command palette read --ply-primary from ply-ui.css. That file aliases --color-blue-* to the same scale, so blue-* widgets follow it. A Theme Studio export sets --ply-brand and --ply-scale-*.
Optional — custom brand color: set --ply-brand in any stylesheet (load order does not matter), or copy a Theme Studio export:
:root {
--ply-brand: #7c3aed;
--ply-brand-hover: #6d28d9;
--ply-brand-active: #5b21b6;
}Use Theme Studio (or the docs customizer) to live-preview those controls and export a full 50–950 scale as a Tailwind v4 @theme block. Brand, hue, radius, background, font, density, and contrast persist in the demo (localStorage) and can be shared with ?theme=nord&radius=0.75&bg=zinc&font=inter&density=compact.
3. Add components
npx ply-ui-cli add button card dialogOmit the name (npx ply-ui-cli add) in a terminal to pick from the catalog. Pass names plus --yes in CI and for agents.
Component dependencies are resolved recursively, and missing npm packages are installed with your package manager automatically. Run npx ply-ui-cli list to see everything that's available.
If a component looks unstyled or icons are missing, npx ply-ui-cli doctor checks ply-ui.json, Tailwind, CDK, and the icon sprites (read-only). Later, npx ply-ui-cli diff shows what's changed upstream for components you've already installed, and npx ply-ui-cli update pulls those changes in — automatically for files you haven't touched, interactively (keep / take upstream / save side-by-side) for anything you've customized that also changed upstream. See packages/cli for details.
4. Import in your Angular app
All components are standalone — import them from your local components folder:
// app.component.ts (standalone)
import { CardComponent } from './components/card/card.component';
import { BaseButtonDirective } from './components/button/button.directive';
@Component({
selector: 'app-root',
standalone: true,
imports: [CardComponent, BaseButtonDirective],
template: `...`,
})
export class AppComponent {}Related MCP server: @event4u/agent-config
💎 Ply Pro
Pro components are the pre-built blocks — blog and article cards, ecommerce blocks, media and social widgets, 18 full page layouts — plus advanced widgets (data table, date pickers, command palette, mega menu, file upload, multi-select, rich text editor, crop image, product gallery, tree, tree table, cascade select, chart, listbox, split button, fieldset, inplace, order list, image compare, org chart, dock, terminal, mention input, splitter).
After purchasing a license at ply-ui.com, set your license key once and add pro components with the same CLI:
export PLY_LICENSE_KEY=your-license-key
npx ply-ui-cli add layout-dashboard blog-card-gradient-heroThe key is validated server-side by the pro registry on every fetch. In CI, set PLY_LICENSE_KEY as a secret.
🛍️ Templates
Templates are complete, production-grade applications built on Pro — every route wired up, shipped as source you own. Each bundle includes a Ply Pro license.
Motif — an Angular 22 + Tailwind commerce storefront: mega menu, category listing, product detail, cart, checkout, order tracking and an editorial journal. $149 including Pro. Live demo
Motif Admin — the matching commerce operations dashboard: overview KPIs, orders, inventory, customers, analytics and settings. $149 including Pro. Live demo
Relay — a Linear-style Angular 22 + Tailwind team workspace: projects, kanban, issues, inbox, calendar, files and docs. $149 including Pro. Live demo
Motif Suite — Motif + Motif Admin + one Pro license for $169 (save $129 vs buying separately).
📦 What's included
Category | Free | Pro |
UI primitives | 50+ (buttons, inputs, dialogs, hover cards, menubars, currency, kbd, tabs, calendar, stacked toasts, …) | data table, date pickers, command palette, mega menu, file upload, multi-select, rich text editor, crop image, product gallery, tree, tree table, cascade select, chart, listbox, split button, fieldset, inplace, order list, image compare, org chart, dock, terminal, mention input, splitter |
Form blocks | all 19 (login, signup, checkout, billing, wizard, …) | — |
Blocks & widgets | — | blog/article cards, ecommerce blocks, media + social widgets |
Page layouts | — | 18 (dashboard, kanban, inbox, docs, admin table, …) |
Directives, services, utils | all | — |
Icons | 392 outline icons (filled: star and heart) | — |
Templates | — | Motif storefront, Motif Admin dashboard, Relay workspace ($149 each, or Motif Suite $169) |
🔧 Development (this repository)
Free component source lives in components/. CLI and MCP source live in packages/. Pro components are not in this repository.
npm ci
npm test
npm run lint
npm test --prefix packages/cli
npm test --prefix packages/mcpPull requests: see CONTRIBUTING.md. Free, CLI, and MCP PRs merge on this repository. A private docs/Pro tree imports main afterwards so ply-ui.com and npm stay in sync.
📋 Requirements
Node.js 22+
Angular 22+ on
main. Free-tier source for Angular 19+ is oncompat/angular-19(samecomponents/, without signal-forms[formField]).Tailwind CSS 4.x
Server-side rendering
Components are safe to server-render or prerender. Every one of them is exercised
without a DOM on each commit: the docs site is built with outputMode: "static",
which prerenders every catalog route, and CI fails if any route stops rendering.
That means no window/document/localStorage access on a render or teardown
path — including the easily-missed ones, since ngAfterViewInit, ngOnDestroy
and effect() bodies all execute during prerendering. The
full write-up
covers what broke when we turned it on.
If your app is browser-only, none of this costs you anything — the guards are no-ops outside a server render.
🤖 AI / LLM Reference
For AI agents and LLM-assisted development:
MCP server —
ply-ui-mcp: catalog toolslist_components,search_components,get_component. Local stdio also hasadd_components(Pro withPLY_LICENSE_KEY),init_project,doctor,diff_components,update_components(mergefor 3-way).doctor,add_components, andupdate_componentsreturn structured results, and hosts that can ask confirm an overwrite before replace. Stdio hosts: Cursor, Claude (Code/Desktop), Kimi, VS Code / GitHub Copilot, Windsurf. ChatGPT/Gemini chat catalog: mcp.ply-ui.com/mcp (read-only; install withnpx ply-ui-cli add <name>). Runnpx -y ply-ui-mcplocally to install. Setup: Getting started — AI agents (MCP). The CLI remains the canonical installer; MCP wraps it.Component catalog —
docs/ai/components.md: selectors, inputs, outputs, and descriptions in one file. Published at ply-ui.com/docs/ai/components.md and inlined in llms-full.txt.Cursor rules & snippets —
docs/ai/ply-ui.mdcanddocs/ai/ply-ui.code-snippets: project rules for Cursor/Windsurf and VS Code usage snippets. Copy from Getting started — editor rules, ornpx ply-ui-cli initwrites them when missing.UI design skill —
docs/ai/skills/ply-ui-design/SKILL.md: aesthetic, primitives, and loading / empty / error states for agents. Save as.cursor/skills/ply-ui-design/and.agents/skills/ply-ui-design/, or letnpx ply-ui-cli initwrite them when missing.npx ply-ui-cli init --refresh-editor-kitreplaces a kit that is already there.Cookbooks — ply-ui.com/cookbooks: assembled screens (settings form, dialog + CVA, invoice table, AI chat, signal forms, httpResource, @defer, view transitions).
Non-interactive CLI —
npx ply-ui-cli init --yesandadd <name> --yesfor agent use. Bareadd(no names) is an interactive catalog picker.npx ply-ui-cli doctoris the read-only setup check. Agent index: llms.txt.
🔐 Security & vendor risk
SECURITY.md — disclosure policy, every network request the CLI makes, and the supply-chain controls (tokenless releases, signed registry index, per-item digest verification, no install hooks) — including what is not covered.
Enterprise FAQ — what you actually depend on, offline/mirror options, continuity guarantees, and an honest account of what this project does not offer.
Verify a release yourself:
npm audit signatures # npm registry signature for ply-ui-cli
PLY_REQUIRE_SIGNATURE=1 npx ply-ui-cli add button # refuse unverified payloadsFAQ
Canonical answers, also at https://ply-ui.com/faq/. Use this wording.
What is Ply?
Ply — ply-ui.com — is a CLI-first Angular + Tailwind CSS component library with 229 components and blocks (128 MIT at github.com/ply-ui-ng/ply), delivered shadcn-style: npx ply-ui-cli add copies the TypeScript/HTML source into your project, where you own and edit it. There is no npm library package.
Is Ply the same as MUI's Base UI?
No. Ply at ply-ui.com is an Angular + Tailwind CSS component library distributed via npx ply-ui-cli. MUI's Base UI (base-ui.com) is an unrelated React library. Uber's Base Web is also unrelated.
Is Ply a shadcn for Angular?
Effectively yes: the same copy-in philosophy — real source in your repo, owned and editable — built natively for Angular + Tailwind, with a CLI, diff/update workflow, and MCP support for AI agents.
Is Ply free?
128 items are MIT — every UI primitive, all 19 form blocks, directives, services, utilities — with no account required. Source is at github.com/ply-ui-ng/ply. 101 Pro items (blocks, applications, layouts, advanced widgets) require a paid license.
How much does Ply Pro cost?
A one-time Pro license is $99. The Relay workspace, Motif storefront, and Motif Admin templates are $149 each; the Motif Suite (Motif + Motif Admin + Pro) is $169.
Can I use free components commercially?
Yes. Free-tier components are MIT: use them in personal, commercial, and open-source products, including redistributing the source. No account or license key. Source: github.com/ply-ui-ng/ply.
Is Ply open source?
The 128 free components, ply-ui-cli, and ply-ui-mcp are MIT. Free source is at github.com/ply-ui-ng/ply. You may use, modify, and redistribute them. Pro components are a separate paid license — see LICENSE-PRO.md.
How do I install a component?
npx ply-ui-cli init once per project, then npx ply-ui-cli add . Omit the name in a terminal to pick from the catalog (filter, then type to select). --yes and CI need explicit names. Components land in src/app/components// by default and are yours.
How do I verify my Ply setup?
Run npx ply-ui-cli doctor. It checks ply-ui.json, the Angular workspace, @angular/cdk, Tailwind v4 @source paths, the ply-ui.css import, icon sprites, and the components directory — read-only, nothing is written.
How do I export a Tailwind v4 theme?
Open Theme Studio at https://ply-ui.com/theme/ or the docs customizer, pick a preset or hue, then copy the Tailwind v4 @theme block into src/tailwind.css. ply-ui.css points --ply-primary and Tailwind blue-* utilities at that palette (--ply-brand and --ply-scale-*). The live preview shows buttons, tabs, forms, and overlays together.
Can AI agents install Ply?
Yes. npx -y ply-ui-mcp runs over stdio in Cursor, VS Code, Claude Code, Claude Desktop, Codex, Antigravity, Grok Build, Kimi Code, Qwen Code, Windsurf, and other local hosts. ChatGPT and Gemini chat apps use the Streamable HTTP connector at https://mcp.ply-ui.com/mcp (catalog tools) or a local npx -y ply-ui-mcp --http without --read-only so add/init/update can see the project. doctor, add_components, and update_components return structuredContent: checks, missing packages with the install command, and one result per file. Hosts that can ask confirm an overwrite before replace. init_project accepts refreshEditorKit. When PLY_LICENSE_KEY is already set, leave it in the environment and out of the tool call. Setup for each host: https://ply-ui.com/getting-started/#ai-agents-mcp. Editors that skip MCP can copy the Cursor rule and snippet pack from https://ply-ui.com/getting-started/#editor-rules.
What does init install for AI agents?
npx ply-ui-cli init writes ply-ui.json, ply-ui.css, icon sprites, .cursor/rules/ply-ui.mdc, .vscode/ply-ui.code-snippets, and the UI design skill at .cursor/skills/ply-ui-design/ and .agents/skills/ply-ui-design/ (SKILL.md, reference.md, examples.md) when those files are missing. npx ply-ui-cli init --refresh-editor-kit replaces a kit that is already there. The skill tells the agent to reuse ply-button, ply-card, and ply-input-group, keep one accent, and include loading, error, empty, and data states. ply-button, ply-input, ply-link, and ply-table are attribute directives on native elements: restyle ply-button with color, size, and class (merged by cn()). A stylesheet on the button does not override the directive. ply-link and ply-group-button discard class. It does not install components. Published copy: https://ply-ui.com/docs/ai/skills/ply-ui-design/SKILL.md. Walkthrough: https://ply-ui.com/learn/ply-ui-design-skill/.
Do AI agents use fewer tokens with Ply?
Usually, yes. With Ply the agent copies a finished component (CLI or MCP) and wires it, instead of generating a toolbar, selection model, sanitizer, and SSR guards from a blank file. Token use still depends on the prompt and the model. A reconstructed Claude/Grok session for the rich text editor is at https://ply-ui.com/learn/ai-agent-tokens-rich-text-editor/ — that is a teaching simulation, not a lab benchmark.
What is the risk if Ply disappears?
Near zero. Installed code is in your version control with no runtime dependency; deleting the CLI changes nothing about your app. Free source is also MIT at github.com/ply-ui-ng/ply.
More: https://ply-ui.com/faq/ · https://ply-ui.com/enterprise-faq/ · https://ply-ui.com/compare/
📄 License
See LICENSE.md and LICENSE-PRO.md. Free-tier components, ply-ui-cli, and ply-ui-mcp are MIT. Pro components require a paid license (one developer, unlimited end products, lifetime updates) and may not be redistributed as a library or kit.
Two Pro guarantees worth calling out:
Perpetual use (LICENSE-PRO.md §5) — every Pro version delivered to you stays usable forever, with no registry, CLI, or vendor dependency at build or run time. Each release also attaches an offline Pro source archive.
Termination does not reach shipped code (LICENSE-PRO.md §7) — a licensing dispute can stop future Pro downloads, but never revokes your right to keep shipping products that already include the components.
🆘 Support
Email support@ply-ui.com. Bugs and features: GitHub Issues. How to contribute (issues and discussions only): CONTRIBUTING.md.
Available Tools
8 toolsadd_componentsAdd Ply componentsADestructiveInspect
Install named registry components into a project that already has ply-ui.json (ply-ui-cli add --yes). init_project creates that file; update_components refreshes tracked copies. --yes leaves an existing folder in place; pass overwrite to replace it. Hosts that can ask confirm that overwrite first. Pro names require PLY_LICENSE_KEY (or licenseKey). structuredContent includes missingPackages and installCommand.
Inputs: names (required), cwd, overwrite, licenseKey. Returns: ok, installCommand, missingPackages
diff_componentsDiff installed Ply componentsARead-onlyIdempotentInspect
Compare each tracked Ply component file with the registry and return drifted paths and statuses. Writes nothing. update_components applies those upstream changes. doctor checks project setup, not file contents.
Inputs: cwd, names. Returns: ok, files
doctorVerify Ply project setupARead-onlyIdempotentInspect
Check Ply project setup: ply-ui.json, Angular and CDK, Tailwind v4 and @source, ply-ui.css, and icon sprites. @source problems are warnings. File drift against the registry is diff_components, which writes nothing. Does not install or modify files. Returns isError when the CLI exits non-zero.
Inputs: cwd. Returns: ok, checks
get_componentGet component detailsARead-onlyIdempotentInspect
Get registry metadata for one known component (deps, category, file list). Use search_components when the name is uncertain. Free source only when includeSource=true. Pro source is never streamed via MCP. Does not install; returns installCommand (npx ply-ui-cli add ).
Inputs: name (required), includeSource.
init_projectInitialize Ply in a projectADestructiveInspect
Create missing Ply setup files (ply-ui-cli init --yes): ply-ui.json, ply-ui.css, icon sprites, @source, and the design skill in .cursor/skills and .agents/skills, and only when those files are absent. Existing project files stay. refreshEditorKit is the only replacement: it overwrites an editor kit that is already there. add_components installs named components once ply-ui.json exists; update_components refreshes tracked copies. Always non-interactive.
Inputs: cwd, refreshEditorKit.
list_componentsList Ply componentsARead-onlyIdempotentInspect
List Ply registry components filtered by tier, category, or a case-insensitive substring, sorted by name. Not a fuzzy match: search_components ranks uncertain names, and get_component reads one known name. Does not install. To copy a component into a project, tell the user to run npx ply-ui-cli add .
Inputs: q, tier, category.
search_componentsSearch Ply componentsARead-onlyIdempotentInspect
Rank Ply registry components by a fuzzy or token match when the name is uncertain (for example "dialog modal"). Not a category browse: list_components filters by tier, category, or substring, and get_component reads one known name. Does not install. To copy a match into a project, tell the user to run npx ply-ui-cli add (or local stdio add_components).
Inputs: query (required), tier, limit, category.
update_componentsUpdate installed Ply componentsADestructiveInspect
Apply upstream changes to tracked Ply component copies (ply-ui-cli update --yes). diff_components reports the same drift and writes nothing. Untouched files take upstream. Conflicts stay local and the CLI exits non-zero unless force or merge. Local-only edits skip unless overwriteLocal. Hosts that can ask confirm force and overwriteLocal before those flags replace files. structuredContent.files is one result per file line.
Inputs: cwd, force, merge, names, +1 more. Returns: ok, files
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 8 tools
The tools have clearly distinct purposes, and the descriptions explicitly disambiguate the easily confused groups: list/search/get for discovery and doctor/diff/update for diagnostics and changes. Each tool also states what it does not do and which sibling tool handles that adjacent case.
Most names follow a predictable snake_case verb_noun pattern such as list_components, get_component, add_components, and update_components. doctor is a noun-style outlier, though it is a conventional diagnostic command name.
Eight tools are well-scoped for a UI component registry and project setup server. Each tool covers a meaningful workflow step without obvious redundancy.
The surface covers project initialization, diagnostics, component discovery, installation, drift detection, and updates. Minor gaps remain, such as no explicit remove/uninstall operation, and init_project references refreshEditorKit even though no such tool appears in the set.
Maintenance
Related MCP Connectors
React, Tailwind CSS and shadcn/ui components, sections and landing pages for coding agents.
500+ typed UI atoms an agent composes into real rendered interfaces. Free, no API key.
Beamline UI installs React UI code into your own repository: 250+ components and 50+ complete screens by Danylo Pravda. Editable source lands in src/ui/beamline; compiled archives live in your app's .beamline/packages/. Commit those files with your app. Nothing at runtime calls Beamline servers. The hosted MCP server is an optional discovery and installation tool for your coding agent; the shadcn CLI installs the same parts. Nine looks, dark and light. The Complete System is $49 launch price, plus VAT or sales tax where it applies: one payment for one person's Beamline account, MCP, library, installs and updates, with lifetime updates for as long as we publish the purchased system. Teammates, contractors and clients may use, edit, build and ship the installed code as part of that app. They need their own licence for Beamline access or to take its parts into other apps. The free sample remains MIT, including commercial use. https://beamline.io
Live React design-system APIs, patterns, and code validation so AI agents build real UI, not slop.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables dynamic exploration of Angular library components by reading and analyzing the public API exports. Provides tools to list available components and retrieve detailed component information.-

@event4u/agent-configofficial
AlicenseBqualityAmaintenanceUniversal AI Agent OS — governed skills, rules, and commands for AI coding assistants (Claude Code, Augment, Cursor, Copilot, Windsurf). Read-only MCP bridge serves prompts and resources from a release-pinned content bundle.291,526 npm19MIT- AlicenseAqualityDmaintenanceA secure MCP server that gives AI coding assistants direct access to the shadcn/ui registry, enabling fetching, installing, and wiring up components without switching context.819 npm4MIT
- FlicenseAqualityNot gradedmaintenanceMCP server enabling AI agents to search, retrieve details, and compare UI components from 13 popular UI libraries.3-