Skip to content

Building themes with AI ​

Stayblox themes work well with AI coding agents such as Claude Code and Cursor. The platform gives your agent three things: machine-readable docs, an agent-ready scaffold, and a local MCP server with validation and preview tools.

Machine-readable documentation ​

Point your agent at either URL, or rely on the bundled offline search described below.

Start from the scaffold ​

bash
npm install -g @stayblox/cli
stayblox theme init my-theme

The scaffold includes two files that make agents productive immediately:

  • AGENTS.md describes the theme structure and the validate-after-every-change loop.
  • .mcp.json registers the stayblox mcp server, so agent tools are available as soon as the agent opens the project.

The dev MCP server ​

Run stayblox mcp (agents with .mcp.json support start it automatically). Tools useful for theme work:

ToolWhat it does
search_docsSearches this documentation offline.
validate_themeValidates the theme against the platform rules and returns structured errors.
package_themeBuilds the distributable zip without uploading.
push_devUploads the theme to your development store and returns a preview URL.

Validation and preview call the Stayblox API, so run stayblox login once before starting your agent.

A working loop ​

  1. Describe the change you want to the agent.
  2. The agent edits the theme's Liquid files, then calls validate_theme and fixes every reported error.
  3. The agent calls push_dev and gives you the preview URL to review.

© Stayblox — Developer Platform