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.

ToolWhat it gives youHow to get it
wix-headless.devThe headless build-and-deploy workflow, referenced by URL.Nothing to install. Paste the skill URL into your prompt.
Wix pluginWix Skills and the Wix MCP together.A single command in a supported client.
Wix SkillsSelf-contained instruction sets, including the Wix Headless skill.npx skills add wix/skills
Wix MCPLive 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. 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. 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 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 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 is a reference site that hosts a skill.md file. The skill instructs your AI agent on how to scaffold and deploy a Wix-managed headless project using the CLI.

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

Copy

Your new project appears in your 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. To give your agent richer, persistent context for ongoing work, install the Wix plugin.

Install the Wix plugin

For ongoing AI development, the Wix plugin adds both Wix Skills and the Wix MCP 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.

For other AI clients like Claude Desktop, Windsurf, or n8n, configure the Wix MCP directly.

Install just Wix Skills

If you want the skill instruction sets without the Wix MCP, install Wix Skills 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:

Copy

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

Configure just the Wix MCP

The Wix MCP 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 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.
  • 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

Did this help?