# Quilt MCP server

> Lets an AI coding agent read and write an infinite-canvas design board: create projects, generate and edit HTML screens, and export prototypes.

- Repository: https://github.com/Bearisbug/Quilt
- Page: https://hostedmcp.org/servers/bearisbug/quilt
- Transport: stdio
- Stars: 106
- License: Apache-2.0

## Install

### Claude Code

```sh
claude mcp add quilt -- npx -y quilt-canvas
```

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

```json
{
  "mcpServers": {
    "quilt": {
      "command": "npx",
      "args": [
        "-y",
        "quilt-canvas"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "quilt": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "quilt-canvas"
      ]
    }
  }
}
```

### VS Code CLI

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

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

```json
{
  "mcpServers": {
    "quilt": {
      "command": "npx",
      "args": [
        "-y",
        "quilt-canvas"
      ]
    }
  }
}
```

### Codex

```sh
codex mcp add quilt -- npx -y quilt-canvas
```

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

```toml
[mcp_servers.quilt]
command = "npx"
args = ["-y", "quilt-canvas"]
```

### Gemini CLI

```sh
gemini mcp add -s user quilt npx -- -y quilt-canvas
```

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

```json
{
  "mcpServers": {
    "quilt": {
      "command": "npx",
      "args": [
        "-y",
        "quilt-canvas"
      ]
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `ANTHROPIC_API_KEY` | no | no |  |
| `GEMINI_API_KEY` | no | no |  |
| `LLM_DRIVER` | no | no |  |

## FAQ

### Does the Quilt MCP server require authentication?

No. The server only listens on loopback, so there is no authentication; API keys stay in the settings panel.

### What tools does the Quilt MCP server expose?

It provides 57 tools and 7 resources covering projects, screen reading and writing, sketchbook drafts, shared components, the design system and model jobs.

### How do I avoid conflicting writes from two agents?

Writes carry an expectedRevisionId and return 409 when the base revision is stale, so two writers cannot overwrite each other.

### How should an agent read screens efficiently?

Call get_outline first for a compact summary of every screen, then get_screen for the screens you actually need.
