Shopify MCP Proxy & Mock Server (ShopifyMCPMockShop) MCP Server

A Shopify MCP Server built to interact with Mock.shop

Local serverstdioTypeScript

What is the Shopify MCP Proxy & Mock Server (ShopifyMCPMockShop) MCP server?

Most payments and commerce work still happens through a UI a human drives. Shopify MCP Proxy & Mock Server (ShopifyMCPMockShop) MCP server moves it into the conversation instead. A Shopify MCP Server built to interact with Mock.shop.

The short version

This project implements a Model Context Protocol (MCP) server that acts as an intelligent bridge and proxy to Shopify's Storefront API. It uniquely supports mock.shop for safe development and testing without requiring real store credentials.

The tools it exposes

The server publishes 11 tools. What each one is for:

  • Cursor — ** ~/.cursor/mcp.json (or similar)
  • getShopInfo — Fetches basic shop details (name, description, currency)
  • getProductById — Fetches a specific product by ID. If includeImages is true, returns JSON details and the first image (75px) as a base64 ImageContentBlock
  • findProducts — Searches/filters products with pagination/sorting
  • getCollectionById — Fetches a specific collection by ID, optionally including products
  • findCollections — Searches/filters collections with pagination/sorting
  • cartCreate — Creates a new shopping cart
  • cartLinesAdd — Adds line items to an existing shopping cart
  • cartLinesUpdate — Updates line items (e.g., quantity) in an existing shopping cart
  • cartLinesRemove — Removes line items from an existing shopping cart
  • getCart — Fetches the details of an existing shopping cart by ID

What it needs from you

Configuration is passed through the environment: SHOPIFY_STORE, SHOPIFY_ACCESS_TOKEN, SHOPIFY_VERSION, ADMIN_ACCESS_TOKEN. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.

Getting it running

Setup follows the usual MCP pattern — install or clone the server, register it in your client's configuration file, restart the client. The configuration blocks on this page cover the common clients.

How it compares

Plenty of payments and commerce servers cover similar ground. The differences that matter in practice are scope of access and how much setup stands between you and a working tool call. Shopify MCP Proxy & Mock Server (ShopifyMCPMockShop)'s toolset — Cursor, getShopInfo, getProductById and 8 more — is a fair guide to whether it matches your workflow. It is maintained by ramakay; worth a glance at recent repository activity before you build anything load-bearing on it.

SyncDev reviews every entry in this directory against the project's own documentation before publishing, and revisits them as servers change.

Things to watch

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • With 11 tools registered it takes up a noticeable share of the context window; turn it off in projects that never touch Shopify MCP Proxy & Mock Server (ShopifyMCPMockShop).
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

Available tools

ToolWhat it does
Cursor** ~/.cursor/mcp.json (or similar)
getShopInfoFetches basic shop details (name, description, currency).
getProductByIdFetches a specific product by ID. If includeImages is true, returns JSON details and the first image (75px) as a base64 ImageContentBlock.
findProductsSearches/filters products with pagination/sorting.
getCollectionByIdFetches a specific collection by ID, optionally including products.
findCollectionsSearches/filters collections with pagination/sorting.
cartCreateCreates a new shopping cart.
cartLinesAddAdds line items to an existing shopping cart.
cartLinesUpdateUpdates line items (e.g., quantity) in an existing shopping cart.
cartLinesRemoveRemoves line items from an existing shopping cart.
getCartFetches the details of an existing shopping cart by ID.

How to install the Shopify MCP Proxy & Mock Server (ShopifyMCPMockShop) MCP server

{
  "mcpServers": {
    // ... other servers ...
    "shopify-mcp": {
      "command": "node",
      "args": [
        "/full/path/to/ShopifyMCPMockShop/dist/server.js"
      ],
      "env": {
        // Only needed if connecting to a REAL store:
        // "SHOPIFY_STORE": "your-store.myshopify.com",
        // "SHOPIFY_ACCESS_TOKEN": "your-storefront-token",
        // "SHOPIFY_VERSION": "2025-04"
      },
      "disabled": false,
      "alwaysAllow": []
    }
    // ... other servers ...
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

VariableDescriptionRequired
SHOPIFY_STOREConfiguration value read at startup.Optional
SHOPIFY_ACCESS_TOKENCredential the server authenticates with.Yes
SHOPIFY_VERSIONConfiguration value read at startup.Optional
ADMIN_ACCESS_TOKENCredential the server authenticates with.Yes

Example prompts to try

  • Use Shopify MCP Proxy & Mock Server (ShopifyMCPMockShop) to Cursor.
  • Use Shopify MCP Proxy & Mock Server (ShopifyMCPMockShop) to getShopInfo.
  • Use Shopify MCP Proxy & Mock Server (ShopifyMCPMockShop) to getProductById.

Frequently asked questions

`mock.shop` is a free, publicly accessible Shopify sandbox environment. The server uses it by default when no real store credentials are provided. It allows safe testing and development without impacting a live store.