@cascivo/mcp

List available component registries: the cascade directory plus any configured via CASCADE_REGISTRIES env.

List all cascade components, optionally filtered by category and/or type.

Get the full manifest (props, states, tokens, a11y, examples) for one component.

Fuzzy search components by name, tags, or description.

Add a component to the current project by running the cascade CLI.

List marketplace templates (whole-page compositions) from the static catalog, optionally filtered by category, tag, framework, or verified status.

Get one marketplace template by name or install spec — its components, install command, demo link, and screenshots.

Install a marketplace template (its components + page/fixture files) into the current project by running the cascade CLI.

Scaffold a complete, ready-to-run cascivo app (Vite + React + TypeScript) wired with the app shell, side navigation, header, and a theme — one page per nav section, with signal-driven section switching. Runs `cascivo create` as a child process, writing the project into a new <name> directory.

Generate a cascade theme CSS file from three colors.

[Deprecated — use scaffold_view instead] Generate a JSX page layout from a description.

Validate a CascadeView JSON config against the registry. Returns errors with exact paths.

Generate a valid starter ViewConfig from a description. Always validates before returning.

Generate a starter declarative <Flow nodes edges /> (from @cascivo/flow) for a node/edge diagram — flowchart, DAG, or pipeline. Returns serializable nodes/edges plus ready-to-paste JSX. Edit the labels/edges to match the intent.

Get the bound-vocabulary grammar + system prompt for generating valid ViewConfig JSON, derived from the component manifests. Use this to constrain an LLM to cascivo's real components, props, and enum values (anti-hallucination). Optionally scope to a subset of components.

Get the cascade token catalog (closed set). Agents must select from this catalog rather than hard-coding values. Returns the CANONICAL token set by default — exactly one name per purpose. Pass includeAliases: true to also list backwards-compat aliases, each tagged with its canonical name.

Resolve an icon by intent. cascivo icon export names differ from Lucide/Radix (e.g. LayoutDashboard→Dashboard, Rocket→Spaceship), so guessing an import name wastes a compile. Pass a concept, a familiar foreign name, or an intent word ("deploy", "git branch") and get the matching @cascivo/icons exports ranked by relevance. Omit the query to list every icon name.

Get the deterministic token variant matrix: a map from design intent (a colour role + state slot, e.g. accent + hover) to the exact token name, plus every semantic/component token resolved to a concrete value in each theme. Use this to answer "what is the warm theme\'s accent-hover value?" or "which token is the active state of primary?" without guessing how layered theme CSS resolves.

Run cascivo's structural invariants over candidate component source (TSX and/or CSS) before writing it to disk. Catches banned React hooks, off-scale @media/@container breakpoints, missing static fallbacks for progressive CSS (@function/if()), and hallucinated --cascivo-* tokens. Use this to self-correct generated code in a loop until `valid` is true.

List the cascivo concept guides available to get_guide (getting-started, theming, tokens, troubleshooting, …).

Get the full markdown of one cascivo concept guide by slug (e.g. "getting-started", "theming", "troubleshooting"). Use list_guides for the slugs.

Get intent, whenToUse/whenNotToUse, and authoring guidance for one component by name.

Heuristic ranking of cascade components by natural language need. Returns top matches with scores and reasons. Note: heuristic ranking, not a model call.