Shopbuddy

io.github.tmill313Published by GitHub account tmill313v0.3.1Updated Oct 24, 2026

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

VerifiedStreamable HTTPWeb executableDeveloper ToolsBusiness & Commerce

Overview

AI-generated overview

Shop Buddy lets an AI agent edit a Shopify theme safely: changes go to a staging theme, get validated and screenshotted, then need owner approval.

What you can do
  • Start a change by duplicating the live theme into a staging theme and a server-side working copy
  • Read, search and write theme files, then run Theme Check validation
  • Push a preview to staging and capture before/after mobile and desktop screenshots with a plain-language summary
  • Submit the change and request publishing, handing the store owner a one-tap approval link
  • Roll back a published change with one tap
When to use it
Useful when you want an AI coding agent to make Shopify theme edits without touching the live storefront, and you want validation, visual review and an approval step before anything goes live.
Requirements
Either the hosted remote endpoint (sign in through the browser and click Allow, no keys) or the local CLI run with npx, which needs Node.js and no account for local mode. The API key variable SHOPBUDDY_API_KEY and the platform URL variable SHOPBUDDY_API_URL are declared; OAuth authentication is required for the hosted service. A Shopify store is needed.
Before you install
The agent writes theme files and can upload to a staging theme; publishing is gated by owner approval, but stores can opt into trusted publishing so low-risk changes publish on request. Rollback is available but changes still reach the store. Theme content and screenshots are processed by a hosted third-party service, so review its privacy and terms. The service is independent and not affiliated with Shopify.

Installation

In SourceWeft

  1. Open Shopbuddy in the dashboard and add it to a workspace.
  2. Connect the required credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.tmill313%2Fshopbuddy/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config. The client completes OAuth sign-in on first connect.

{
  "mcpServers": {
    "shopbuddy": {
      "type": "http",
      "url": "https://getshopbuddy.vercel.app/api/mcp"
    }
  }
}

README

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

[Add to Cursor] [Add to VS Code] [npm]

bash
# 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-pluginclaude plugin install shopbuddy@shopbuddy-marketplace
# Codexcodex 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.

Source: README.md at commit 5207bab

Tools

0
This server asks you to sign in, so SourceWeft could not read its tools without an account and has not indexed them. What a connected account sees can depend on that account and its permissions.

Version history

1
  1. v0.3.1LatestSep 16, 2026

Score

85% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts