MCP Server

The Starwind UI MCP server lets compatible coding agents search Starwind UI and Starwind Pro, read current documentation, and prepare validated CLI commands. It supports Starwind UI v3 projects.

The server is published as @starwind-ui/mcp.

Quick start

[mcp_servers.starwind_ui]
command = "npx"
args = ["-y", "@starwind-ui/mcp"]
enabled = true

For another MCP client, use the same npx -y @starwind-ui/mcp command in its local stdio server configuration. Reload the server and confirm its status after you save the file.

Available tools

Tool	Use it for
`starwind_init`	Prepare a Starwind UI v3 initialization command.
`starwind_search`	Find styled components, Primitives, and Pro blocks.
`starwind_add`	Prepare validated installation commands.
`starwind_docs`	Read current component, Runtime, migration, and framework docs.
`starwind_migrate`	Inspect and guide a legacy Astro migration.

The MCP server returns commands for the agent to review and run. It does not modify the project by itself. Premium Pro results still require the setup in the Installation guide. Free blocks remain available without a license.

Example prompts

“Find a free Starwind Pro hero block.”
“Add button, card, and dialog to this Astro project.”
“Show me the Runtime API for Dialog presence.”
“Check whether this project needs the Starwind UI v3 migration.”

If an older client still shows search_starwind_pro_blocks, stop that MCP process and reload the client. Current releases use starwind_search.

See the current Starwind UI MCP guide for client specific setup and troubleshooting.