AI Integration

# AI Integration

Your AI coding assistant (Windsurf, Cursor, Claude Code, etc.) can build with Starwind Pro directly. No hallucinated imports, no outdated examples. Install the MCP server, hook it to your AI tool, and prompt away.

<span class="sr-only">If you're an AI assistant reading this documentation, the Starwind MCP server provides tools for project initialization, documentation lookup, component installation, and block search. For base Starwind UI component reference, see [starwind.dev/llms.txt](https://starwind.dev/llms.txt) and [starwind.dev/llms-full.txt](https://starwind.dev/llms-full.txt).</span>

## MCP Server

The Starwind MCP server gives your AI assistant four powerful tools to scaffold projects, pull live docs, install blocks, and search the Pro library.

### Quick Start

The MCP server is published as [@starwind-ui/mcp](https://www.npmjs.com/package/@starwind-ui/mcp). Add it to your AI tool's MCP configuration:

<DocsTabs defaultValue="windsurf" syncKey="ide" class="min-h-[140.49px]">
<DocsTabsList>
<DocsTabsTrigger value="windsurf">Windsurf</DocsTabsTrigger>
<DocsTabsTrigger value="cursor">Cursor</DocsTabsTrigger>
<DocsTabsTrigger value="claude">Claude Code</DocsTabsTrigger>
<DocsTabsTrigger value="codex">Codex</DocsTabsTrigger>
</DocsTabsList>
<DocsTabsContent value="windsurf">
```json title="mcp_config.json"
{
  "mcpServers": {
    "starwind-ui": {
      "command": "npx",
      "args": ["-y", "@starwind-ui/mcp"],
      "env": {}
    }
  }
}
```
</DocsTabsContent>
<DocsTabsContent value="cursor">
```json title="mcp.json"
{
  "mcpServers": {
    "starwind-ui": {
      "command": "npx",
      "args": ["-y", "@starwind-ui/mcp"],
      "env": {}
    }
  }
}
```
</DocsTabsContent>
<DocsTabsContent value="claude">
```json title=".mcp.json"
{
  "mcpServers": {
    "starwind-ui": {
      "command": "npx",
      "args": ["-y", "@starwind-ui/mcp"],
      "env": {}
    }
  }
}
```
</DocsTabsContent>
<DocsTabsContent value="codex">
```toml title=".codex/config.toml"
[mcp_servers.starwind_ui]
command = "npx"
args = ["-y", "@starwind-ui/mcp"]
```
</DocsTabsContent>
</DocsTabs>

Detailed setup instructions per IDE:

- [Windsurf MCP Setup](https://docs.windsurf.com/windsurf/cascade/mcp)
- [Cursor MCP Setup](https://cursor.com/docs/context/mcp)
- [Claude Code MCP Setup](https://docs.anthropic.com/en/docs/claude-code/mcp)

### Available Tools

| Tool | Description |
| --- | --- |
| `starwind_init` | One-command project bootstrap with Starwind UI or Pro |
| `starwind_docs` | Pulls live documentation from starwind.dev (cached and topic-filtered) |
| `starwind_add` | Auto-detects your package manager and generates validated install commands |
| `search_starwind_pro_blocks` | Searches Pro blocks by keyword, category, or plan type |

### Example Prompts

Once the MCP server is connected, try prompts like:

- "Scaffold a clean SaaS fintech landing page using only free Starwind Pro blocks"
- "Drop in a 3-plan pricing table component with annual toggle"
- "Add an animated, responsive navbar from Starwind Pro to my Astro layout"
- "Search for all hero blocks and install the one with an image background"

Your AI assistant will use the MCP tools to search the block library, find the right components, and generate the correct install commands for your package manager.

## Starwind UI Reference Files

Starwind Pro blocks are built on top of the open-source [Starwind UI](https://starwind.dev) component library. For AI tools that need reference material on the base components (Button, Card, Dialog, etc.), two structured files are available:

- **Overview** ([llms.txt](https://starwind.dev/llms.txt)): Quick reference with component list, import patterns, and key links
- **Full Reference** ([llms-full.txt](https://starwind.dev/llms-full.txt)): Complete API documentation with props, variants, and code examples

> **Tip:** Most AI tools can consume these files directly via URL. Point your assistant at `https://starwind.dev/llms-full.txt` if it needs detailed component specs for the base library.

## Feedback

If you encounter any issues or have suggestions, please [open an issue](https://github.com/starwind-ui/starwind-ui/issues) on GitHub or reach out in the [Discord community](https://discord.gg/hYxyyFHNJb).