English Français العربية

io.github.tmill313/shopbuddy

Official registry E-commerce

Safe Shopify theme changes for AI agents: staging, validation, visual review, approval, rollback.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http shopbuddy 'https://getshopbuddy.vercel.app/api/mcp'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "shopbuddy": {
            "type": "http",
            "url": "https://getshopbuddy.vercel.app/api/mcp"
        }
    }
}
NPM package shopbuddy
Claude Code 
claude mcp add shopbuddy -e 'SHOPBUDDY_API_URL=<SHOPBUDDY_API_URL>' -e 'SHOPBUDDY_API_KEY=<your shopbuddy_api_key>' -- npx -y shopbuddy@0.3.0 mcp
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "shopbuddy": {
            "command": "npx",
            "args": [
                "-y",
                "shopbuddy@0.3.0",
                "mcp"
            ],
            "env": {
                "SHOPBUDDY_API_URL": "<SHOPBUDDY_API_URL>",
                "SHOPBUDDY_API_KEY": "<your shopbuddy_api_key>"
            }
        }
    }
}

Environment variables

  • SHOPBUDDY_API_URL Platform URL
  • SHOPBUDDY_API_KEY secret API key from the platform's Install page

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Shop Buddy
  2. How it works
  3. What is in this repo
  4. Privacy and terms

Shop Buddy

Let your AI coding agent change your Shopify theme safely. Every edit lands on an unpublished staging theme. Shop Buddy validates it with Theme Check, screenshots before/after on mobile and desktop with a plain-language summary of what changed, and you approve with one tap. Rollback is one tap. The live theme is never edited directly.

Site and one-click install: **https://getshopbuddy.vercel.app/install**

# Claude Code (hosted MCP, signs in through your browser)
claude mcp add --transport http shopbuddy https://getshopbuddy.vercel.app/api/mcp

# Claude Code plugin (adds the skill too)
claude plugin marketplace add tmill313/shopbuddy-plugin
claude plugin install shopbuddy@shopbuddy-marketplace

# Codex
codex mcp add shopbuddy --url https://getshopbuddy.vercel.app/api/mcp

# Local CLI (no account needed for local mode)
npx shopbuddy

Claude (web/desktop) and ChatGPT: add a custom connector with https://getshopbuddy.vercel.app/api/mcp. The agent opens a browser tab; sign in or create an account there and click Allow. No keys.

How it works

  1. shopbuddy_start_change duplicates the live theme into a staging theme and pulls it into a server-side working copy.
  2. The agent reads, searches and writes files, runs Theme Check with shopbuddy_validate, then shopbuddy_push_preview uploads to staging and captures before/after screenshots, each visual change attributed to its section.
  3. shopbuddy_submit and shopbuddy_request_publish hand the store owner a one-tap approval link. Owners can opt a store into trusted publishing so low-risk changes publish on request, always logged and one tap from shopbuddy_rollback.

Agent-readable summary: https://getshopbuddy.vercel.app/llms.txt

What is in this repo

This is the public companion to the hosted service: the Claude Code plugin and marketplace manifests, the shopbuddy skill, the MCP client config, and the MCP Registry manifest (io.github.tmill313/shopbuddy). The platform itself is a hosted service; the CLI ships compiled on npm as shopbuddy.

Privacy and terms

https://getshopbuddy.vercel.app/privacy · https://getshopbuddy.vercel.app/terms

Shop Buddy is an independent service, not affiliated with or endorsed by Shopify.

Frequently asked questions

What is io.github.tmill313/shopbuddy?

Safe Shopify theme changes for AI agents: staging, validation, visual review, approval, rollback.

How do I install io.github.tmill313/shopbuddy?

It runs as a remote server. In Claude Code: claude mcp add --transport http shopbuddy 'https://getshopbuddy.vercel.app/api/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.tmill313/shopbuddy need an API key?

Yes. It expects SHOPBUDDY_API_KEY, which you set in its configuration.

Is io.github.tmill313/shopbuddy open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.tmill313/shopbuddy?

It is published by tmill313. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.