On this page

MCP Server

Use the Starwind UI MCP server to search Starwind UI, read current documentation, and generate validated CLI commands from an MCP-compatible assistant. It supports Starwind UI v3 projects using Astro or React.

The server is published as @starwind-ui/mcp and runs locally through your MCP client.

Quick Start

Select your MCP client and add the configuration.

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

{
  "mcpServers": {
    "starwind-ui": {
      "command": "npx",
      "args": ["-y", "@starwind-ui/mcp"],
      "env": {}
    }
  }
}

{
  "mcpServers": {
    "starwind-ui": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@starwind-ui/mcp"],
      "env": {}
    }
  }
}

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "starwind-ui": {
      "type": "local",
      "command": ["npx", "-y", "@starwind-ui/mcp"],
      "enabled": true
    }
  }
}

{
  "servers": {
    "starwind-ui": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@starwind-ui/mcp"]
    }
  }
}

{
  "mcpServers": {
    "starwind-ui": {
      "command": "npx",
      "args": ["-y", "@starwind-ui/mcp"]
    }
  }
}

This project file configures Devin Local, the default agent in new Devin Desktop tabs. You can also create it with devin mcp add -s project starwind-ui -- npx -y @starwind-ui/mcp.

After you add the configuration, reload the MCP server when your client requires it. Use the client’s MCP status view or list command to confirm that Starwind UI connected.

What You Can Do

With the MCP server, an assistant can:

Prepare a validated Starwind UI v3 initialization command for an Astro or React project.
Search styled components, Primitives, and Starwind Pro blocks.
Generate validated install commands for the selected framework and project.
Fetch exact component, Primitive, Runtime, migration, and framework documentation.
Check a legacy Astro project and prepare a safe Starwind UI v3 migration command.

The server inspects local project context when available. It returns commands for the assistant to review with you. It does not run those commands.

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 install commands.
`starwind_docs`	Read current Starwind documentation.
`starwind_migrate`	Check and guide a legacy Astro migration.

Example Prompts

“Find a React combobox and show me its documentation.”
“Add button, card, and dialog to this Astro project.”
“Show me the Primitive and Runtime API for Color Picker.”
“Check whether this project needs the Starwind UI v3 migration.”
“Find free Starwind Pro hero blocks.”

Use Starwind Skills with MCP when your assistant supports both. Skills provide editing guidance. MCP supplies current Starwind data and commands.

Troubleshooting

If the tools do not appear, restart or reload the server from the client’s MCP controls. Confirm that the client can run:

npx -y @starwind-ui/mcp