This MCP server exposes Shopify Storefront capabilities to MCP-compatible AI assistants. The primary tools you can call are: shopify_discover, which detects whether a URL belongs to a Shopify storefront and helps retrieve authentication context; shopify_storefront_graphql, which executes GraphQL queries against the Shopify Storefront API; and customer_data, a unified interface for managing customer-related data stored locally and accessed alongside store data. Use shopify_discover to validate storefront endpoints before issuing GraphQL queries, then leverage shopify_storefront_graphql to fetch products, collections, inventory, or to perform checkout-related mutations. The customer_data tool consolidates create, read, update, and delete operations for customer profiles, addresses, and any custom fields you store, enabling personalized experiences without directly handling raw data in your prompts.

Prerequisites:

• Python 3.8+ installed on your system
• Access to install Python dependencies (pip)

Step-by-step installation:

1. Clone the repository: git clone https://github.com/your-org/quentincody-shopify-storefront-mcp-server.git cd quentincody-shopify-storefront-mcp-server

2. Create and activate a Python virtual environment (recommended): python -m venv venv source venv/bin/activate # On Windows: venv\Scripts\activate

3. Install dependencies: pip install -r requirements.txt

4. Copy the example environment file and populate credentials: cp .env.example .env

   Edit .env and set:

   SHOPIFY_STOREFRONT_ACCESS_TOKEN=your_storefront_token

   SHOPIFY_STORE_NAME=your-store-name

   (Optional) SHOPIFY_API_VERSION=2025-04

   (Optional) SHOPIFY_BUYER_IP=127.0.0.1

5. Run the server: python -m shopify_storefront_mcp_server

Notes:

• Ensure the Storefront API token has the required scopes as described in the README.
• Keep your .env file secure and do not commit it to version control.

Tips and common issues:

• Ensure SHOPIFY_STORE_NAME is the short name (without .myshopify.com).
• Tokens typically start with shpsa_ or shpat_ depending on generation; verify token validity if you encounter authentication errors.
• If you modify environment variables, restart the server to apply changes.
• Customer data is persisted in user_data/customer.json and is not committed to version control. Use the customer_data tool to manage it.
• When integrating with MCP assistants, prefer using shopify_storefront_graphql for dynamic data (products, collections, cart mutations) and shopify_discover to verify storefront context before making requests.