StoreMCP Documentation

Search or list products with title, handle, status, totalInventory, and price range.

Comprehensive product details including variants, SKUs, inventory per variant, and descriptions by product GID.

Create a new product with title, description, vendor, productType, status, and price.

Update title, description, status (ACTIVE/DRAFT), and tags on existing products.

Add new size, color, or custom option variants with specific pricing and SKUs to an existing product.

Permanently delete a product from the Shopify catalog by its global ID.

List all active store warehouses, fulfillment locations, and addresses.

Query stock counts (available, on-hand, committed) across locations or for a specific item.

Adjust or increment available inventory levels for an item at a specific location.

Search or list product collections with title, handle, description, and products count.

Add one or more products to an existing collection by ID.

Search orders by status, financial status, fulfillment state, or customer name.

Order breakdown with line items, quantities, price, shipping address, and fulfillment status.

Create a completed or pending order directly in Shopify with line items, email, notes, and tags.

Create new draft orders with variant lines, custom items, customer assignment, and internal notes.

Cancel active orders specifying reasons (CUSTOMER, INVENTORY, FRAUD, OTHER) and optional restock.

Retrieve abandoned checkouts with recovery URLs, items, totals, and customer details.

Preview and calculate refund amounts, taxes, and restock implications before issuing a refund.

Issue partial or full refunds on an order, with optional inventory restocking and customer email alerts.

Fetch fulfillment orders, assigned warehouse locations, and items awaiting fulfillment.

Fulfill orders with tracking number, carrier (USPS, FedEx, DHL), and automated customer shipping notification.

Place a fulfillment order on hold for fraud review, missing inventory, or address verification.

List or search active discount codes and automatic promotions with status, summary, and usage count.

Create percentage (e.g. 0.20 for 20%) or fixed-amount discount promo codes with optional expiration dates and usage limits.

Permanently delete a code discount or automatic discount by global ID.

Search issued gift cards with initial values, remaining balances, and customer details.

Create and issue a new gift card with a balance, optional recipient customer, and expiration date.

Search customer records by name, email, order count, or lifetime spend.

Create new customer profiles with first/last name, email, phone, note, and tags.

List customer segments configured in the store with their query definitions.

Retrieve custom metafields attached to any resource (product, collection, order, customer) or for the store.

Batch create or update custom metafields with key, namespace, value, and type.

Delete a metafield by its global ID.

Safely append tags to a resource (Product, Customer, Order, etc.) without overwriting existing tags.

Remove specific tags from a resource without affecting other existing tags.

Returns store metadata (name, currencyCode, plan, email, primaryDomain, timezoneOffset).

Retrieve the store's legal and operational policies (refund, privacy, terms of service, shipping).

Search and list digital media files, images, videos, and documents stored in Shopify.

Execute arbitrary raw GraphQL queries or mutations against the Shopify Admin API with JSON variables support. Allows AI agents to query or mutate any Shopify entity within granted OAuth scopes.