# Polyxd MCP server

> Allows AI clients to write, validate, and render UI documents as interactive screens using various design-system packs.

- Repository: https://github.com/visualfart/polyxd
- Page: https://hostedmcp.org/servers/visualfart/mcp
- Transport: stdio, remote
- Stars: 5
- License: Apache-2.0
- Latest version: 0.4.6

## Install

### Claude Code

```sh
claude mcp add mcp -- npx -y @polyxd/mcp
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@polyxd/mcp"
      ]
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@polyxd/mcp"
      ]
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"mcp","type":"stdio","command":"npx","args":["-y","@polyxd/mcp"]}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@polyxd/mcp"
      ]
    }
  }
}
```

### Codex

```sh
codex mcp add mcp -- npx -y @polyxd/mcp
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.mcp]
command = "npx"
args = ["-y", "@polyxd/mcp"]
```

### Gemini CLI

```sh
gemini mcp add -s user mcp npx -- -y @polyxd/mcp
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@polyxd/mcp"
      ]
    }
  }
}
```

## Tools (7)

- `polyxd_guide`
- `polyxd_validate`
- `polyxd_verify`
- `polyxd_show`
- `polyxd_packs`
- `polyxd_components`
- `polyxd_docs`

## FAQ

### How do I connect to the Polyxd server via URL?

You can connect by pasting the URL into Claude's custom connectors, using the Claude Code CLI, or adding it to the configuration files for Cursor or VS Code.

### Does the server require an account or sign-in?

No, the hosted server does not require an account or sign-in to use.

### What happens if there are errors in the UI document?

The polyxd_show tool will not show the document if there are errors.
