> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

## Resource: Headless AI Toolkit

## Article: Headless AI Toolkit

## Article Link: https://dev.wix.com/docs/go-headless/get-started/headless-ai-toolkit.md

## Article Content:

# Headless AI Toolkit

The Wix Headless AI toolkit gives AI coding clients such as Claude Code, Cursor, VS Code, and Codex the context they need to build and manage a Wix Headless project from your prompts.

Go from a single prompt to a deployed project, then keep prompting to extend your project's features and functionality.

## Available tools

Wix integrates with your AI client in several ways, and they overlap. Use the table to compare what each option gives you and how to get it. Then use the questions below to find the right fit.

| Tool | What it gives you | How to get it |
|---|---|---|
| [`wix-headless.dev`](#build-with-a-single-prompt) | The headless build-and-deploy workflow, referenced by URL. | Nothing to install. Paste the skill URL into your prompt. |
| [Wix plugin](#install-the-wix-plugin) | Wix Skills and the Wix MCP together. | A single command in a supported client. |
| [Wix Skills](#install-just-wix-skills) | Self-contained instruction sets, including the Wix Headless skill. | `npx skills add wix/skills` |
| [Wix MCP](#configure-just-the-wix-mcp) | Live access to Wix docs, API calls, and project, site, and app management. | Configure it in your client. |

### Choose your tool

- **Launching a project right now?** Reference the [`wix-headless.dev` skill URL](#build-with-a-single-prompt). There's nothing to install. Paste the URL into your prompt and your agent does the rest.
- **Building and managing in a supported client?** Install the [Wix plugin](#install-the-wix-plugin). It bundles Wix Skills and the Wix MCP, so your client can scaffold projects, search docs, and call Wix APIs with no extra setup.
- **Want the instructions, but not the live connection?** Install [Wix Skills](#install-just-wix-skills) on their own, without the Wix MCP's live access to Wix docs and APIs.
- **On an unsupported client, or only need live docs and APIs?** Configure the [Wix MCP](#configure-just-the-wix-mcp) directly. This covers clients like Claude Desktop, Windsurf, and n8n.

> **Note:** The Wix plugin already includes the Wix Headless skill, which is the same as the `wix-headless.dev` skill. If you've installed the plugin, you don't need to use the `wix-headless.dev` skill. Prompt your agent to build a headless project.

## Build with a single prompt

You can build a fully customizable headless project with a single prompt, without installing anything. [wix-headless.dev](https://wix-headless.dev/) is a reference site that hosts a [skill.md](https://www.wix-headless.dev/skill.md) file. The skill instructs your AI agent on how to scaffold and deploy a Wix-managed headless project using the [CLI](https://dev.wix.com/docs/wix-cli.md).

To start, describe what you want to build to your AI agent and include the skill URL. For example:

```bash
"Build a storefront for handmade ceramics"
using https://www.wix-headless.dev/skill.md
```

Your new project appears in your [dashboard](https://support.wix.com/en/article/about-your-wix-dashboard) alongside your sites.

From here you can keep prompting your agent to extend your project's features and functionality, or continue developing manually with the [CLI](https://dev.wix.com/docs/wix-cli.md). To give your agent richer, persistent context for ongoing work, install the [Wix plugin](#install-the-wix-plugin).

## Install the Wix plugin

For ongoing AI development, the Wix plugin adds both [Wix Skills](https://dev.wix.com/docs/api-reference/articles/ai-tools/about-wix-skills.md) and the [Wix MCP](https://dev.wix.com/docs/api-reference/articles/ai-tools/wix-mcp/about-the-wix-mcp.md) to your AI client. Once installed, the client can search Wix documentation, scaffold projects, and call Wix APIs directly from your chat.

Select your client and follow the steps to get started.

::::tabs

:::Cursor

For development in Cursor, install the Wix plugin using either of these methods:

- **From the AI chat:** Run the following command:

  ```text
  /add-plugin wix
  ```

- **From the marketplace:** Install it from the [Cursor marketplace](https://cursor.com/marketplace/wix).

:::

:::Claude-Code

For development in Claude Code, install the Wix plugin using either of these methods:

- **From claude.com:** Open the [Wix plugin page](https://claude.com/plugins/wix) and click **Install in Claude Code**. Claude Code opens and installs the plugin for you.

- **From Claude Code:** Run the following command:

  ```text
  /plugins install wix
  ```

:::

:::Codex

For development with Codex:

1. In a terminal, register the Wix Skills marketplace:

   ```bash
   codex plugin marketplace add wix/skills
   ```

2. In the Codex CLI, run `/plugins`, select **Wix**, and choose **Install Plugin**.

:::

:::VS-Code

To install the Wix plugin in VS Code:

1. Open the Command Palette by pressing `Control+Shift+P` (or `Command+Shift+P` on macOS).
2. Select **Chat: Install Plugin From Source**.
3. Enter `https://github.com/wix/skills`.

:::

::::

For other AI clients like Claude Desktop, Windsurf, or n8n, [configure the Wix MCP](https://dev.wix.com/docs/api-reference/articles/ai-tools/wix-mcp/about-the-wix-mcp.md) directly.

## Install just Wix Skills

If you want the skill instruction sets without the Wix MCP, install [Wix Skills](https://dev.wix.com/docs/api-reference/articles/ai-tools/about-wix-skills.md) on their own. Skills are self-contained instruction sets for Wix development tasks, including the Wix Headless skill, which can scaffold and deploy a complete headless project from a single prompt.

To install Wix Skills, run:

```bash
npx skills add wix/skills
```

> **Note:** Add `-g` to install globally and make Wix Skills available across all your projects.

## Configure just the Wix MCP

The [Wix MCP](https://dev.wix.com/docs/api-reference/articles/ai-tools/wix-mcp/about-the-wix-mcp.md) is a Model Context Protocol server that lets your AI client search Wix docs, scaffold code, and call Wix APIs directly from your IDE. It's included in the Wix plugin, but you can also [configure it directly](https://dev.wix.com/docs/api-reference/articles/ai-tools/wix-mcp/about-the-wix-mcp.md) for clients that don't support the plugin, such as Claude Desktop, Windsurf, or n8n.

## Programmatic docs access

Beyond the toolkit, you can pull Wix docs into any tool or workflow:

- **llms.txt index:** Browse a structured index of all documentation at [dev.wix.com/docs/llms.txt](https://dev.wix.com/docs/llms.txt.md).
- **Markdown format:** Append `.md` to any documentation page URL to retrieve the Markdown version of that page.
- **Page menu:** Use the **Ask Assistant** dropdown on any documentation page to copy the page as Markdown or get a direct link to the Markdown version.

## See also

- [About Wix-Managed Headless](https://dev.wix.com/docs/go-headless/wix-managed-headless/about-wix-managed-headless.md)
- [Featured Business Solutions for Wix Headless](https://dev.wix.com/docs/go-headless/cross-path-guides/featured-business-solutions.md)