shopify-operations-mcp

io.github.jpka/shopify-operations-mcpv0.1.1E-commerce

Safe-write Shopify operations: plan-before-execute writes with out-of-band approval and audit.

In-path gate · all MCP tools

Using shopify-operations-mcp in Claude, Cursor, Gemini CLI, Cline, or Zed?

MCP tool contracts can change remotely with no version bump. The mcpindex gate pins each contract and HOLDs the call when it drifts-before your agent acts. Zero credentials. This is not the package install for this server itself (use Install this server for that).

Install the mcpindex gate (one command)

Rewrites your MCP host config so each server launches behind the gate. Inspect first: curl -fsSL https://mcpindex.ai/install.sh | less

uv tool install mcpindex-gate && mcpindex-config-wire

Auditable install path →Watch it hold a drift →

Trust verdict · v1 advisory · method

NOT YET SCREENEDno verdict on file

Verdict not yet evaluated for this tool. The semantic screen takes adversarial cases first; coverage rolls out as the corpus expands (15/150 labels to graduation). The deterministic conformance probe is built but has not yet run on the public corpus, so a recorded verdict here is REVIEW or UNVERIFIED, never a clearing ALLOW. Until a verdict is recorded, an agent should treat this tool as not-yet-cleared and fall back to its own checks. Method: the eval, four-state verdict, honest limits.

Own this server? Screen its description →

That verdict was true at screening time (snapshot 2026-08-16).

Contracts can change after screening, with no version bump. The gate pins shopify-operations-mcp’s tool contracts on first sight and holds any silent change before your agent acts - the check that keeps being true on Tuesday.

See your first HOLD in 2 minutes →

Environment variables

SHOPIFY_STORE_DOMAIN

required

The myshopify.com store domain, e.g. my-store.myshopify.com. Overrides shopify.storeDomain from the config file.

SHOPIFY_ADMIN_TOKEN

requiredsecret

Shopify Admin API access token. Required and only ever read from the environment — never from the config file.

SHOPIFY_CONFIG

Path to a config.json with shopify/plans/approvalServer/protectedTags settings. Defaults to ./config.json in the working directory.

SHOPIFY_PLAN_TTL_MS

How long a plan token stays valid before it must be executed or expires, in milliseconds. Default 60000.

SHOPIFY_APPROVAL_SERVER_PORT

Port the localhost human-approval HTTP server binds to (127.0.0.1 only). Default 4319.

SHOPIFY_PROTECTED_TAGS

Comma-separated tags that plans may never modify; any plan touching an item carrying one is refused. Default do-not-touch.

SHOPIFY_CALLER_ID

Identity recorded as the caller on every audit log row. Default unknown.

SHOPIFY_AUDIT_PATH

File path for the tamper-evident JSONL audit log. Default shopify-operations-audit.jsonl in the working directory.

MCP quality score · maturity, not trust · methodology

freshness

completeness

installability

documentation

stability

Alternatives in E-commerce

Verity Score

io.verityscore/geo-audit

GEO audit for Shopify: AI readiness score, recommendations, and 15 vertical checklists.

Curie Commerce

co.curie/commerce

Search, compare in 3D, and buy products from 5.6M+ Shopify stores. Free tier; Pro adds checkout.

Magento Cloud MCP Server

io.github.juan-cinto-infracommerce/magento-cloud

MCP server for Adobe Commerce Cloud — REST API + SSH, no PHP CLI required

Install this server

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "shopify-operations-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "--",
        "shopify-operations-mcp"
      ],
      "env": {
        "SHOPIFY_STORE_DOMAIN": "<shopify_store_domain>",
        "SHOPIFY_ADMIN_TOKEN": "<your-shopify_admin_token>",
        "SHOPIFY_CONFIG": "<shopify_config>",
        "SHOPIFY_PLAN_TTL_MS": "<shopify_plan_ttl_ms>",
        "SHOPIFY_APPROVAL_SERVER_PORT": "<shopify_approval_server_port>",
        "SHOPIFY_PROTECTED_TAGS": "<shopify_protected_tags>",
        "SHOPIFY_CALLER_ID": "<shopify_caller_id>",
        "SHOPIFY_AUDIT_PATH": "<shopify_audit_path>"
      }
    }
  }
}

Cursor (.cursor/mcp.json)

{
  "mcpServers": {
    "shopify-operations-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "--",
        "shopify-operations-mcp"
      ],
      "env": {
        "SHOPIFY_STORE_DOMAIN": "<shopify_store_domain>",
        "SHOPIFY_ADMIN_TOKEN": "<your-shopify_admin_token>",
        "SHOPIFY_CONFIG": "<shopify_config>",
        "SHOPIFY_PLAN_TTL_MS": "<shopify_plan_ttl_ms>",
        "SHOPIFY_APPROVAL_SERVER_PORT": "<shopify_approval_server_port>",
        "SHOPIFY_PROTECTED_TAGS": "<shopify_protected_tags>",
        "SHOPIFY_CALLER_ID": "<shopify_caller_id>",
        "SHOPIFY_AUDIT_PATH": "<shopify_audit_path>"
      }
    }
  }
}

Cline (cline_mcp_settings.json)

npx -y -- shopify-operations-mcp

Claude Code (claude mcp add)

claude mcp add --scope user shopify-operations-mcp -- npx -y -- shopify-operations-mcp

Gemini CLI (gemini mcp add)

gemini mcp add -s user shopify-operations-mcp npx -y -- shopify-operations-mcp

Verdict API

curl -s mcpindex.ai/api/v1/trust/server/io-github-jpka-shopify-operations-mcp

Free-tier verdict as JSON: decision + dimensions + severity. Call it from your agent before it invokes a tool it just discovered.

Details

version: v0.1.1
category: E-commerce
quality: 85 / 100
operator: jpka

Listing

Listed from the official MCP registry. Unclaimed by its maintainer. Maintainer? Email us →

Provenance

Each verdict is bound to a hash of the exact description it judged, so a re-crawl that changes the text produces a new record rather than silently inheriting this one. Verdict history is hash-chained and anchored to Bitcoin via OpenTimestamps (latest confirmed at block 962,524). Verify it yourself.

Links

Repository →