basecoat-ui
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| BASECOAT_PROJECT_ROOT | No | Overrides the launch directory to select the host application's DESIGN.md. It is not the MCP installation directory. This is overridden by --project-root. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| resources | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| search_componentsA | Find up to 8 compact component summaries by intent and/or query (either field may be omitted). Valid component IDs include: button, card, dialog, dropdown-menu, table, tabs, badge, avatar, input, select, etc. Next step: Call get_component_details or basecoat_component_syntax with the selected component id. |
| get_component_detailsA | Get one minimal component template, dependencies, and composition tips for Astro or HTML. Valid IDs: any of the 57 Basecoat components (button, card, dialog, dropdown-menu, table, tabs, badge, etc.). When called with {}, returns the top-level component catalog index. Next step: Call validate_composition or basecoat_quality_inspector after integrating markup. |
| get_component_htmlA | Fetch HTML markup template and dependencies for a Basecoat component. Valid IDs: any of 57 Basecoat components. When called with {}, returns the top-level component catalog index. Next step: Call validate_composition or basecoat_quality_inspector to audit. |
| validate_compositionA | [STAGE 4: QUALITY AUDIT] Statically check HTML/Astro source for Basecoat migration errors, semantic rhythm, FSM bindings, missing scripts, nested cards, spacing and hierarchy issues. Pass code or alias html and optionally a semanticProfile and densityProfile. Does not render or evaluate dynamic code. Next step: Fix any errors/warnings reported in the diagnostic output. |
| validate_markupA | [STAGE 4: QUALITY AUDIT] Alias of validate_composition. Statically check HTML/Astro source for Basecoat migration errors, semantic rhythm, FSM bindings, missing scripts, nested cards, spacing and hierarchy issues. Next step: Fix any errors/warnings reported in the diagnostic output. |
| search_macro_blocksA | Search approved macro layout blocks by query, role, family, or tag. Optional design/page/slot context filters to slot-compatible roles. Returns summaries and immutable refs only; use cursors for more. |
| get_macro_blockA | Retrieve one section of a compiled macro block blueprint (manifest, structure, slots, ports, rules, dependencies, provenance). Follow next cursors until complete. Optional designId pins aliases to that session registry. |
| begin_designA | Create a persistent design session under the host project root. Pass designId, profile (alias or ref), operationId, and optional decisions. Pins and hash-verifies the packaged macro registry. Idempotent for the same operationId. Oversized optional receipt fields may be omitted with truncated:true after commit. |
| get_design_contextA | Read a focused design view: sessions (no designId), overview, decisions, graph, rules, focus, or next. Pin revision on first read; continuations must match. Does not create sessions. |
| apply_design_patchA | Apply one atomic list of design graph operations with expectedRevision and operationId. Replay with the same operationId returns the original receipt. A committed mutation always acknowledges success; oversized optional fields may be omitted with truncated:true. Does not write application source files. |
| validate_designA | Validate a design session (or one page) in draft or complete mode. Returns totals plus paginated diagnostics. A plan-ready graph is not proof of rendered correctness. |
| get_rhythm_rulesA | Read the effective semantic rhythm profile by family, including project-local overrides under a contained .basecoat/rhythm.json. Semantic IDs and approved implementation utilities are returned separately. Results are content-addressed and cursor-paginated; changed effective revisions invalidate prior cursors. |
| get_fsm_recipeB | Read finite FSM states, events, guards, actions, or transitions. Recipes are structural metadata, not executable runtime code. |
| basecoat_setup_configA | [STAGE 1: ARCHITECT] Generate production Tailwind CSS v4 @import statements, OKLCH design tokens, @theme inline blocks, and theme bootstrap scripts for a selected framework (astro, vanilla, nextjs, sveltekit, vite, htmx) and style pack (vega, nova, maia, lyra, mira, luma, sera, rhea). Next step: Call basecoat_compose_stack or basecoat_page_architect. |
| basecoat_page_architectA | [STAGE 1: ARCHITECT] Search and retrieve complete layout scaffolds (Workspace Dashboard, Auth Split-Screen, Data Table Detail, Workspace Settings, Pricing, etc.) with explicit slot markers, grid structures, and responsive containers. Next step: Call basecoat_rules_enforcer and basecoat_creative_director, then basecoat_compose_stack or basecoat_component_syntax. |
| basecoat_rules_enforcerB | [STAGE 2: RULES & RHYTHM] Retrieve indexed technical implementation constraints covering strict Tailwind CSS v4 syntax, mandatory FSM data-state contracts, semantic CSS variable tokens, and semantic HTML landmarks. Next step: Call basecoat_creative_director or basecoat_component_syntax. |
| basecoat_creative_directorB | [STAGE 2: RULES & RHYTHM] Surface Kanso minimalism and Basecoat design intelligence: typography ladders, optical spacing rhythm, whitespace density, contrast ratios, style packs, and subtle elevation strategies. Next step: Call basecoat_compose_stack or basecoat_component_syntax. |
| basecoat_compose_stackA | [STAGE 3: SYNTAX & STACKS] Assemble full shell architectures (sidebar-01..16, topbar-shell, inset-shell, split-shell) and hydrate pre-configured component stacks (kpi-4-col-delta, area-revenue-stack, data-table-full-crud, detail-inspector-drawer, field-group-settings) into slots with optical density control. Next step: Call basecoat_quality_inspector to verify markup compliance. |
| basecoat_component_syntaxA | [STAGE 3: SYNTAX & STACKS] Retrieve copy-pasteable Basecoat component markup with pre-configured FSM state variants (default, active, loading, disabled, open, closed) and dependencies for any of the 57 Basecoat components. Next step: Call basecoat_quality_inspector to audit assembled markup. |
| basecoat_list_chartsA | [STAGE 3: SYNTAX & STACKS] List and filter 50+ Basecoat ApexCharts and SVG data visualization blueprints by category (area, bar, line, pie, radar, radial, tooltip) or keyword search/query. Next step: Call basecoat_get_chart_blueprint with the selected chart ID. |
| basecoat_get_chart_blueprintA | [STAGE 3: SYNTAX & STACKS] Retrieve complete chart markup, CSS theme tokens (--chart-1..5), layout footprint, client options, and framework mount code (vanilla, astro, react, vue, svelte) with optional theme token overrides for a specific chart blueprint ID or category. Next step: Call basecoat_quality_inspector to audit the assembled page. |
| basecoat_quality_inspectorB | [STAGE 4: QUALITY AUDIT] Audit HTML/Astro markup and return a structured quality report with Score (0-100), Syntax Violations, Accessibility/ARIA omissions, and Auto-Fix suggestions. Final quality gate for all generated Basecoat UI code. |
| setup_configB | [STAGE 1: ARCHITECT] Alias of basecoat_setup_config. Generate production Tailwind CSS v4 setup, OKLCH tokens, and theme scripts. |
| get_page_architectB | [STAGE 1: ARCHITECT] Alias of basecoat_page_architect. Search and retrieve complete layout scaffolds with explicit slot markers. |
| enforce_rulesC | [STAGE 2: RULES & RHYTHM] Alias of basecoat_rules_enforcer. Retrieve indexed technical implementation constraints. |
| get_creative_directionC | [STAGE 2: RULES & RHYTHM] Alias of basecoat_creative_director. Surface Kanso minimalism and Basecoat design intelligence. |
| compose_stackA | [STAGE 3: SYNTAX & STACKS] Alias of basecoat_compose_stack. Assemble shell architectures and hydrate pre-configured component stacks into slots. |
| get_component_syntaxA | [STAGE 3: SYNTAX & STACKS] Alias of basecoat_component_syntax. Retrieve copy-pasteable Basecoat component markup with FSM state variants. |
| list_chartsB | [STAGE 3: SYNTAX & STACKS] Alias of basecoat_list_charts. List and filter 50+ Basecoat ApexCharts and SVG data visualization blueprints. |
| get_chart_blueprintB | [STAGE 3: SYNTAX & STACKS] Alias of basecoat_get_chart_blueprint. Retrieve complete chart markup, CSS theme tokens, and client options. |
| inspect_qualityB | [STAGE 4: QUALITY AUDIT] Alias of basecoat_quality_inspector. Audit HTML/Astro markup and return a structured quality report. |
| get_design_rulesA | Retrieve technical implementation constraints covering Tailwind CSS v4 syntax, mandatory FSM data-state contracts, semantic CSS variables, and HTML landmarks. When called with {}, returns the top-level catalog index. |
| list_blocksA | Alias of search_macro_blocks. Search or list approved macro layout blocks by query, role, family, or tag. When called with {}, returns the top-level macro block catalog index. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| design-rhythm | Content hierarchy, spatial rhythm, density, typography, and composition constraints. |
| design-theming | Basecoat token contract, class-based dark mode with one resolver (basecoat.theme / themeMode), no-flash bootstrap, form control and autofill pitfalls. |
| framework-integration | Production integration (Astro, Next.js, Express/Node), Tailwind 4 setup, and framework-agnostic usage. |
| project-context | Read DESIGN.md from the explicitly configured host project root; bounded local data. |
| skills-core | Master UI/UX protocol and 57-component reference for Basecoat UI (pure Basecoat CSS, headless Tailwind CSS v4, Kanso minimalism, and mandatory FSM data-state contracts). |
| skills-dashboard | Master UI/UX architecture and generation protocol for Basecoat UI dashboard layouts, shell architectures, and block patterns. |
| skills-charts | Basecoat Charts skill for ApexCharts and SVG data visualization mapped to CSS tokens (--chart-1..5). |
| skills-file-basecoat-components-accordion-md | Basecoat skill reference file: basecoat/components/accordion.md |
| skills-file-basecoat-components-alert-dialog-md | Basecoat skill reference file: basecoat/components/alert-dialog.md |
| skills-file-basecoat-components-alert-md | Basecoat skill reference file: basecoat/components/alert.md |
| skills-file-basecoat-components-aspect-ratio-md | Basecoat skill reference file: basecoat/components/aspect-ratio.md |
| skills-file-basecoat-components-avatar-md | Basecoat skill reference file: basecoat/components/avatar.md |
| skills-file-basecoat-components-badge-md | Basecoat skill reference file: basecoat/components/badge.md |
| skills-file-basecoat-components-breadcrumb-md | Basecoat skill reference file: basecoat/components/breadcrumb.md |
| skills-file-basecoat-components-button-group-md | Basecoat skill reference file: basecoat/components/button-group.md |
| skills-file-basecoat-components-button-md | Basecoat skill reference file: basecoat/components/button.md |
| skills-file-basecoat-components-calendar-md | Basecoat skill reference file: basecoat/components/calendar.md |
| skills-file-basecoat-components-card-md | Basecoat skill reference file: basecoat/components/card.md |
| skills-file-basecoat-components-carousel-md | Basecoat skill reference file: basecoat/components/carousel.md |
| skills-file-basecoat-components-chart-md | Basecoat skill reference file: basecoat/components/chart.md |
| skills-file-basecoat-components-checkbox-md | Basecoat skill reference file: basecoat/components/checkbox.md |
| skills-file-basecoat-components-collapsible-md | Basecoat skill reference file: basecoat/components/collapsible.md |
| skills-file-basecoat-components-combobox-md | Basecoat skill reference file: basecoat/components/combobox.md |
| skills-file-basecoat-components-command-md | Basecoat skill reference file: basecoat/components/command.md |
| skills-file-basecoat-components-context-menu-md | Basecoat skill reference file: basecoat/components/context-menu.md |
| skills-file-basecoat-components-data-table-md | Basecoat skill reference file: basecoat/components/data-table.md |
| skills-file-basecoat-components-date-picker-md | Basecoat skill reference file: basecoat/components/date-picker.md |
| skills-file-basecoat-components-dialog-md | Basecoat skill reference file: basecoat/components/dialog.md |
| skills-file-basecoat-components-drawer-md | Basecoat skill reference file: basecoat/components/drawer.md |
| skills-file-basecoat-components-dropdown-menu-md | Basecoat skill reference file: basecoat/components/dropdown-menu.md |
| skills-file-basecoat-components-empty-md | Basecoat skill reference file: basecoat/components/empty.md |
| skills-file-basecoat-components-field-group-md | Basecoat skill reference file: basecoat/components/field-group.md |
| skills-file-basecoat-components-field-md | Basecoat skill reference file: basecoat/components/field.md |
| skills-file-basecoat-components-form-md | Basecoat skill reference file: basecoat/components/form.md |
| skills-file-basecoat-components-hover-card-md | Basecoat skill reference file: basecoat/components/hover-card.md |
| skills-file-basecoat-components-input-group-md | Basecoat skill reference file: basecoat/components/input-group.md |
| skills-file-basecoat-components-input-otp-md | Basecoat skill reference file: basecoat/components/input-otp.md |
| skills-file-basecoat-components-input-md | Basecoat skill reference file: basecoat/components/input.md |
| skills-file-basecoat-components-item-md | Basecoat skill reference file: basecoat/components/item.md |
| skills-file-basecoat-components-kbd-md | Basecoat skill reference file: basecoat/components/kbd.md |
| skills-file-basecoat-components-label-md | Basecoat skill reference file: basecoat/components/label.md |
| skills-file-basecoat-components-menubar-md | Basecoat skill reference file: basecoat/components/menubar.md |
| skills-file-basecoat-components-navigation-menu-md | Basecoat skill reference file: basecoat/components/navigation-menu.md |
| skills-file-basecoat-components-pagination-md | Basecoat skill reference file: basecoat/components/pagination.md |
| skills-file-basecoat-components-popover-md | Basecoat skill reference file: basecoat/components/popover.md |
| skills-file-basecoat-components-progress-md | Basecoat skill reference file: basecoat/components/progress.md |
| skills-file-basecoat-components-radio-group-md | Basecoat skill reference file: basecoat/components/radio-group.md |
| skills-file-basecoat-components-resizable-md | Basecoat skill reference file: basecoat/components/resizable.md |
| skills-file-basecoat-components-scroll-area-md | Basecoat skill reference file: basecoat/components/scroll-area.md |
| skills-file-basecoat-components-select-md | Basecoat skill reference file: basecoat/components/select.md |
| skills-file-basecoat-components-separator-md | Basecoat skill reference file: basecoat/components/separator.md |
| skills-file-basecoat-components-sheet-md | Basecoat skill reference file: basecoat/components/sheet.md |
| skills-file-basecoat-components-sidebar-md | Basecoat skill reference file: basecoat/components/sidebar.md |
| skills-file-basecoat-components-skeleton-md | Basecoat skill reference file: basecoat/components/skeleton.md |
| skills-file-basecoat-components-slider-md | Basecoat skill reference file: basecoat/components/slider.md |
| skills-file-basecoat-components-sonner-md | Basecoat skill reference file: basecoat/components/sonner.md |
| skills-file-basecoat-components-spinner-md | Basecoat skill reference file: basecoat/components/spinner.md |
| skills-file-basecoat-components-switch-md | Basecoat skill reference file: basecoat/components/switch.md |
| skills-file-basecoat-components-table-md | Basecoat skill reference file: basecoat/components/table.md |
| skills-file-basecoat-components-tabs-md | Basecoat skill reference file: basecoat/components/tabs.md |
| skills-file-basecoat-components-textarea-md | Basecoat skill reference file: basecoat/components/textarea.md |
| skills-file-basecoat-components-toast-md | Basecoat skill reference file: basecoat/components/toast.md |
| skills-file-basecoat-components-toggle-group-md | Basecoat skill reference file: basecoat/components/toggle-group.md |
| skills-file-basecoat-components-toggle-md | Basecoat skill reference file: basecoat/components/toggle.md |
| skills-file-basecoat-components-tooltip-md | Basecoat skill reference file: basecoat/components/tooltip.md |
| skills-file-basecoat-customization-md | Basecoat skill reference file: basecoat/customization.md |
| skills-file-basecoat-design-system-md | Basecoat skill reference file: basecoat/design-system.md |
| skills-file-basecoat-install-md | Basecoat skill reference file: basecoat/install.md |
| skills-file-basecoat-mcp-md | Basecoat skill reference file: basecoat/mcp.md |
| skills-file-basecoat-registry-md | Basecoat skill reference file: basecoat/registry.md |
| skills-file-basecoat-rules-composition-md | Basecoat skill reference file: basecoat/rules/composition.md |
| skills-file-basecoat-rules-forms-md | Basecoat skill reference file: basecoat/rules/forms.md |
| skills-file-basecoat-rules-icons-md | Basecoat skill reference file: basecoat/rules/icons.md |
| skills-file-basecoat-rules-styling-md | Basecoat skill reference file: basecoat/rules/styling.md |
| skills-file-basecoat-SKILL-md | Basecoat skill reference file: basecoat/SKILL.md |
| skills-file-basecoat-charts-area-md | Basecoat skill reference file: basecoat-charts/area.md |
| skills-file-charts-area-md | Basecoat skill reference file alias: charts/area.md |
| skills-file-basecoat-charts-audit-checklist-md | Basecoat skill reference file: basecoat-charts/audit/checklist.md |
| skills-file-charts-audit-checklist-md | Basecoat skill reference file alias: charts/audit/checklist.md |
| skills-file-basecoat-charts-audit-SKILL-md | Basecoat skill reference file: basecoat-charts/audit/SKILL.md |
| skills-file-charts-audit-SKILL-md | Basecoat skill reference file alias: charts/audit/SKILL.md |
| skills-file-basecoat-charts-bar-md | Basecoat skill reference file: basecoat-charts/bar.md |
| skills-file-charts-bar-md | Basecoat skill reference file alias: charts/bar.md |
| skills-file-basecoat-charts-line-md | Basecoat skill reference file: basecoat-charts/line.md |
| skills-file-charts-line-md | Basecoat skill reference file alias: charts/line.md |
| skills-file-basecoat-charts-pie-md | Basecoat skill reference file: basecoat-charts/pie.md |
| skills-file-charts-pie-md | Basecoat skill reference file alias: charts/pie.md |
| skills-file-basecoat-charts-radar-md | Basecoat skill reference file: basecoat-charts/radar.md |
| skills-file-charts-radar-md | Basecoat skill reference file alias: charts/radar.md |
| skills-file-basecoat-charts-radial-md | Basecoat skill reference file: basecoat-charts/radial.md |
| skills-file-charts-radial-md | Basecoat skill reference file alias: charts/radial.md |
| skills-file-basecoat-charts-SKILL-md | Basecoat skill reference file: basecoat-charts/SKILL.md |
| skills-file-charts-SKILL-md | Basecoat skill reference file alias: charts/SKILL.md |
| skills-file-basecoat-charts-tooltip-md | Basecoat skill reference file: basecoat-charts/tooltip.md |
| skills-file-charts-tooltip-md | Basecoat skill reference file alias: charts/tooltip.md |
| skills-file-basecoat-dashboard-audit-checklist-md | Basecoat skill reference file: basecoat-dashboard/audit/checklist.md |
| skills-file-basecoat-dashboard-audit-SKILL-md | Basecoat skill reference file: basecoat-dashboard/audit/SKILL.md |
| skills-file-basecoat-dashboard-block-patterns-charts-md | Basecoat skill reference file: basecoat-dashboard/block-patterns/charts.md |
| skills-file-basecoat-dashboard-block-patterns-forms-md | Basecoat skill reference file: basecoat-dashboard/block-patterns/forms.md |
| skills-file-basecoat-dashboard-block-patterns-metrics-md | Basecoat skill reference file: basecoat-dashboard/block-patterns/metrics.md |
| skills-file-basecoat-dashboard-block-patterns-navigation-md | Basecoat skill reference file: basecoat-dashboard/block-patterns/navigation.md |
| skills-file-basecoat-dashboard-block-patterns-sidebars-md | Basecoat skill reference file: basecoat-dashboard/block-patterns/sidebars.md |
| skills-file-basecoat-dashboard-block-patterns-SKILL-md | Basecoat skill reference file: basecoat-dashboard/block-patterns/SKILL.md |
| skills-file-basecoat-dashboard-block-patterns-tables-md | Basecoat skill reference file: basecoat-dashboard/block-patterns/tables.md |
| skills-file-basecoat-dashboard-content-strategy-SKILL-md | Basecoat skill reference file: basecoat-dashboard/content-strategy/SKILL.md |
| skills-file-basecoat-dashboard-foundations-SKILL-md | Basecoat skill reference file: basecoat-dashboard/foundations/SKILL.md |
| skills-file-basecoat-dashboard-foundations-theme-md | Basecoat skill reference file: basecoat-dashboard/foundations/theme.md |
| skills-file-basecoat-dashboard-page-types-auth-md | Basecoat skill reference file: basecoat-dashboard/page-types/auth.md |
| skills-file-basecoat-dashboard-page-types-dashboard-md | Basecoat skill reference file: basecoat-dashboard/page-types/dashboard.md |
| skills-file-basecoat-dashboard-page-types-reading-views-md | Basecoat skill reference file: basecoat-dashboard/page-types/reading-views.md |
| skills-file-basecoat-dashboard-page-types-settings-md | Basecoat skill reference file: basecoat-dashboard/page-types/settings.md |
| skills-file-basecoat-dashboard-page-types-SKILL-md | Basecoat skill reference file: basecoat-dashboard/page-types/SKILL.md |
| skills-file-basecoat-dashboard-SKILL-md | Basecoat skill reference file: basecoat-dashboard/SKILL.md |
TDQS
Scored across 33 tools
Several tools are explicit aliases (validate_composition/validate_markup, basecoat_setup_config/setup_config, basecoat_page_architect/get_page_architect), and the component-retrieval cluster (search_components, get_component_details, get_component_html, basecoat_component_syntax, get_component_syntax) has heavily overlapping purposes. An agent must guess which of several near-identical tools to call.
Names mix conventions: some are bare snake_case (search_components, validate_markup, begin_design) while others carry a basecoat_ prefix (basecoat_setup_config, basecoat_quality_inspector), and the aliases use entirely different stems for the same operation. Verb styles vary across get/search/fetch/read/apply.
33 tools is heavy for the scope, and roughly half are declared aliases of other tools, which inflates the surface without adding capability. The genuine functional set is closer to 18-20, making this bloated.
The workflow surface is fairly complete: setup config, page scaffolds, rules/rhythm, component and chart retrieval, stack composition, design sessions, macro blocks, and a quality audit gate. Minor gaps like no explicit delete/update for design graph artifacts, but the generation lifecycle is well covered.