Skip to content
verify mcp Beta VerifyMCP is currently in beta. If you notice any issues, get in touch and we’ll put it right.

io.github.AIWerk/mcp-server-shopify

NPM · @AIWERK/MCP-SERVER-SHOPIFY · SCANNED AUG 6

Shopify Admin GraphQL API: products, orders, customers, inventory, and more (read and write).

+11 this week 68 Trust /100
Trust breakdown (6 categories)

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score →

Supply Chain Security87
  • No malware found by supply-chain analysis.Pass
  • Known CVEs were checked across the 95 of 99 dependencies we could resolve, so this covers what we could see, not the whole tree.Partial
  • No install/post-install scripts declared.Pass
  • Dependency health was assessed across the 95 of 99 dependencies we could resolve, so this covers what we could see, not the whole tree. View diagnostics → Partial
Provenance & Transparency45
Schema Quality & AI Usability77
  • AI-judged instruction clarity (excellent).Pass
  • Tool/resource definitions use about 2101 tokens (~75/item across 28 items; 28 tools + 0 resources), lean.Pass
  • Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management37
  • Stability observed for 11 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage67
  • 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
  • 0% of tool parameters carry a description.Fail
Capabilities100
  • Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Install

Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.

npm · @aiwerk/mcp-server-shopify

# add to Claude Code
claude mcp add aiwerk-mcp-server-shopify -- npx -y @aiwerk/mcp-server-shopify
# add to Codex CLI
codex mcp add aiwerk-mcp-server-shopify -- npx -y @aiwerk/mcp-server-shopify
// opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "aiwerk-mcp-server-shopify": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@aiwerk/mcp-server-shopify"
      ],
      "enabled": true
    }
  }
}
# add to OpenClaw
openclaw mcp add aiwerk-mcp-server-shopify --command npx --arg -y --arg @aiwerk/mcp-server-shopify
# ~/.hermes/config.yaml
mcp_servers:
  aiwerk-mcp-server-shopify:
    command: "npx"
    args: ["-y", "@aiwerk/mcp-server-shopify"]
// mcp.json
{
  "mcpServers": {
    "aiwerk-mcp-server-shopify": {
      "command": "npx",
      "args": [
        "-y",
        "@aiwerk/mcp-server-shopify"
      ]
    }
  }
}
Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

  • 6 Aug 26 +1

    No change was recorded against any check on this day. Stability & Change Management went from 33 to 37. That category is still filling its 30-day observation window: 10 days of observed history at the previous scan, 11 at this one. The score rises as the window fills, whether or not the server changes.

  • 5 Aug 26 +1
    • CVE-2026-69207 no longer affects this package security
    • Known CVEs: fail → partial security
  • 4 Aug 26 0
    • CVE-2026-69207 affects this package: medium security
    • Known CVEs: partial → fail security
  • 3 Aug 26 +19
    • Provenance: unverified → fail security
    • Known CVEs: unverified → partial security
    • Install scripts: unverified → pass security
    • Stability: unverified → 0.27 functional
    • Maintenance: unverified → pass functional
    • Dependency health: unverified → partial functional
    • License: unverified → pass functional
    • Licence: MIT functional
  • 1 Aug 26 +42
    • Malware scan: unverified → pass security
    • Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window). security
    • Tool coverage: unverified → 100 functional
    • MCP protocol: unverified → pass functional
  • 31 Jul 26 −52
    • We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
  • 30 Jul 26 −18
    • Malware scan: pass → unverified security
  • 28 Jul 26 +51
    • Provenance: unverified → fail security
    • Known CVEs: unverified → partial security
    • Install scripts: unverified → pass security
    • Maintenance: unverified → pass functional
    • Dependency health: unverified → partial functional
    • License: unverified → pass functional
    • Tool coverage: unverified → 100 functional
    • First check of Schema quality: excellent functional
    • First check of Schema quality: fail functional
    • First check of Tool coverage: 0 functional
    • First check of Schema quality: pass functional
    • Licence: MIT functional
Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 6 Aug 2026 · Analysed npm/@aiwerk/[email protected]

Provenance No attestation

The registry publishes no build provenance for this version, so there is nothing to verify.

Result No attestation
Ecosystem npm
Dependencies 95 packages
Packages resolved 95
Deprecated 95
Stale 29
Tree resolution Partial

The dependency tree was only partially resolved, so these counts may be incomplete.

MCP tools — 28 exposed · ~2,101 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.

Tool Tokens
shopify_add_customer_note ~70

Add a note to a customer. mode=append (default) reads the current note and concatenates with two newlines; mode=replace overwrites. Append makes one extra read query.

NameTypeReqDescription
idstringyes
modestring
notestringyes

No output schema declared.

No examples provided.

shopify_add_order_note ~76

Add a note to an order. mode=append (default) reads the current note and concatenates with two newlines; mode=replace overwrites. Required: id, note. Append makes one extra read query.

NameTypeReqDescription
idstringyes
modestring
notestringyes

No output schema declared.

No examples provided.

shopify_add_product_tag ~61

Add one or more tags to a product. Required: productId, tags (non-empty array). Idempotent server-side. Returns the updated product node + userErrors.

NameTypeReqDescription
productIdstringyes
tagsarrayyes

No output schema declared.

No examples provided.

shopify_adjust_inventory_level ~103

Adjust the available or on_hand quantity at a location by a delta (positive or negative integer, non-zero). Uses inventoryAdjustQuantities. Defaults: name=available, reason=correction. Optional: referenceDocumentUri.

NameTypeReqDescription
deltaintegeryes
inventoryItemIdstringyes
locationIdstringyes
namestring
reasonstring
referenceDocumentUristring

No output schema declared.

No examples provided.

shopify_archive_product ~64

Archive a product (sets status to ARCHIVED, hiding it from sale). Reversible. Destructive: requires confirm=true. Without confirm, returns a structured "would do X" response without firing.

NameTypeReqDescription
confirmboolean
idstringyes

No output schema declared.

No examples provided.

shopify_cancel_order ~96

Cancel an order asynchronously (orderCancel returns a job). Destructive: requires confirm=true. Default reason=OTHER, restock=true, refund=false, notifyCustomer omitted.

NameTypeReqDescription
confirmboolean
idstringyes
notifyCustomerboolean
reasonstring
refundboolean
restockboolean
staffNotestring

No output schema declared.

No examples provided.

shopify_complete_draft_order ~71

Complete a draft order, converting it into a real order (draftOrderComplete). Destructive: requires confirm=true. paymentPending=true marks the resulting order as payment pending instead of paid.

NameTypeReqDescription
confirmboolean
idstringyes
paymentPendingboolean

No output schema declared.

No examples provided.

shopify_create_customer ~92

Create a customer (customerCreate). At least one of email/phone is required. Optional: firstName, lastName, note, tags, locale.

NameTypeReqDescription
emailstring
firstNamestring
lastNamestring
localestring
notestring
phonestring
tagsarray

No output schema declared.

No examples provided.

shopify_create_draft_order ~134

Create a draft order. Required: lineItems (non-empty). Each line item needs quantity, plus either variantId (existing variant) or title+originalUnitPrice (custom item). Optional: email, customerId, note, tags, shippingAddress, billingAddress, useCustomerDefaultAddress.

NameTypeReqDescription
billingAddressobject
customerIdstring
emailstring
lineItemsarrayyes
notestring
shippingAddressobject
tagsarray
useCustomerDefaultAddressboolean

No output schema declared.

No examples provided.

shopify_create_product ~103

Create a new product. Required: title. Optional: descriptionHtml, productType, vendor, tags, status (ACTIVE|ARCHIVED|DRAFT, default ACTIVE), handle. Returns product + userErrors.

NameTypeReqDescription
descriptionHtmlstring
handlestring
productTypestring
statusstring
tagsarray
titlestringyes
vendorstring

No output schema declared.

No examples provided.

shopify_get_customer ~50

Get a single customer by GID or numeric ID. Returns full detail including default address, addresses (with truncation marker), tags, locale, and lifetime value.

NameTypeReqDescription
idstringyes

No output schema declared.

No examples provided.

shopify_get_inventory_level ~62

Get the inventory level (available, on_hand, committed, incoming, reserved) for an inventory item at a single location. Required: inventoryItemId, locationId.

NameTypeReqDescription
inventoryItemIdstringyes
locationIdstringyes

No output schema declared.

No examples provided.

shopify_get_order ~48

Get a single order by GID or numeric ID. Returns full detail including line items (with truncation marker), customer, addresses, and financial totals.

NameTypeReqDescription
idstringyes

No output schema declared.

No examples provided.

shopify_get_product ~59

Get a product by GID or numeric ID (e.g. "gid://shopify/Product/123" or "123"). Returns full product detail including variants and images, with truncation markers when capped.

NameTypeReqDescription
idstringyes

No output schema declared.

No examples provided.

shopify_get_shop_info ~36

Get shop-level metadata: name, primary domain, currency, timezone, plan, billing address, contact email, weight unit.

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

shopify_list_collections ~63

List collections with optional Shopify search query. Returns id, title, handle, descriptionHtml, sortOrder, productsCount.

NameTypeReqDescription
afterstring
firstinteger
querystring
reverseboolean

No output schema declared.

No examples provided.

shopify_list_customers ~77

List customers with optional Shopify search query (e.g. "orders_count:>0 country:CH"). Default first=50, max=250.

NameTypeReqDescription
afterstring
firstinteger
querystring
reverseboolean
sortKeystring

No output schema declared.

No examples provided.

shopify_list_locations ~66

List shop locations (warehouses, retail stores). By default excludes inactive and legacy locations; toggle with includeInactive / includeLegacy.

NameTypeReqDescription
afterstring
firstinteger
includeInactiveboolean
includeLegacyboolean

No output schema declared.

No examples provided.

shopify_list_metafields ~90

List metafields on any HasMetafields resource (Product, ProductVariant, Customer, Order, Collection, Shop, Company, Location). Required: ownerId, ownerType. Optional: namespace filter.

NameTypeReqDescription
afterstring
firstinteger
namespacestring
ownerIdstringyes
ownerTypestringyes

No output schema declared.

No examples provided.

shopify_list_orders ~82

List orders with optional Shopify search query (e.g. "financial_status:paid created_at:>2026-01-01"). Default first=50, max=250.

NameTypeReqDescription
afterstring
firstinteger
querystring
reverseboolean
sortKeystring

No output schema declared.

No examples provided.

shopify_list_products ~81

List products with optional Shopify search query syntax (e.g. "status:active vendor:Acme"). Optional pagination via cursor. Default first=50, max=250.

NameTypeReqDescription
afterstring
firstinteger
querystring
reverseboolean
sortKeystring

No output schema declared.

No examples provided.

shopify_mark_order_paid ~48

Mark an order as paid (orderMarkAsPaid). Use for offline payments where the funds were captured outside Shopify. Returns updated order + userErrors.

NameTypeReqDescription
idstringyes

No output schema declared.

No examples provided.

shopify_remove_product_tag ~55

Remove one or more tags from a product. Required: productId, tags (non-empty array). Returns the updated product node + userErrors.

NameTypeReqDescription
productIdstringyes
tagsarrayyes

No output schema declared.

No examples provided.

shopify_search_customers ~74

Search customers by Shopify search query (e.g. "email:[email protected] OR last_name:Smith"). Required: query.

NameTypeReqDescription
afterstring
firstinteger
querystringyes
reverseboolean
sortKeystring

No output schema declared.

No examples provided.

shopify_search_orders ~73

Search orders by Shopify search query (e.g. "name:#1001 OR email:[email protected]"). Required: query.

NameTypeReqDescription
afterstring
firstinteger
querystringyes
reverseboolean
sortKeystring

No output schema declared.

No examples provided.

shopify_search_products ~75

Search products by Shopify search query (full-text + filters like "title:T-Shirt status:active"). Required: query. Optional pagination + sort.

NameTypeReqDescription
afterstring
firstinteger
querystringyes
reverseboolean
sortKeystring

No output schema declared.

No examples provided.

shopify_update_customer ~90

Update a customer (customerUpdate). Required: id. All other fields are optional and only applied if provided.

NameTypeReqDescription
emailstring
firstNamestring
idstringyes
lastNamestring
localestring
notestring
phonestring
tagsarray

No output schema declared.

No examples provided.

shopify_update_product ~102

Update fields on an existing product by GID or numeric ID. Required: id. All other fields are optional and only applied if provided. Returns product + userErrors.

NameTypeReqDescription
descriptionHtmlstring
handlestring
idstringyes
productTypestring
statusstring
tagsarray
titlestring
vendorstring

No output schema declared.

No examples provided.