ShopOps MCP

AI-powered server that implements the Model Context Protocol (MCP) for managing Shopify and WooCommerce stores.

Features

• Store connectors for Shopify and WooCommerce.
• 11 MCP tools covering inventory, pricing, customers, orders, product performance and reporting.
• 4 MCP resources exposing store overview, inventory, recent orders and top customers.
• Inventory forecasting using moving-average demand plus safety-stock calculation.
• RFM-based customer segmentation (7 distinct segments).
• Data-driven pricing analysis with margin-based optimization suggestions.
• Order anomaly / fraud detection.
• ABC analysis of product performance.
• Automated daily and weekly reports.
• Dual transport: local stdio and Streamable HTTP (MCPize).
• TypeScript, @modelcontextprotocol/sdk v1.29+, Zod v4.
• Free tier, plus $25 and $45 paid plans.

Quick Start

# 1. Install the package
npm i shopops-mcp

# 2. Create a .env file (see Configuration section)
cp .env.example .env

# 3. Run the server (local stdio mode)
npx shopops-mcp run --transport stdio

# 4. Or start the HTTP endpoint (MCPize deployment)
npx shopops-mcp run --transport http --port 8080

The server will read the environment variables, connect to the configured store(s), and expose the MCP tools and resources.

MCP Tools

| Tool | Description | |------|-------------| | store_connect | Establishes a connection to a Shopify or WooCommerce store and validates credentials. | | inventory_status | Returns current stock levels, back-order flags and low-stock alerts. | | inventory_forecast | Projects future inventory requirements using moving-average demand and safety-stock buffers. | | pricing_analyze | Generates a price elasticity report and identifies under-/over-priced SKUs. | | pricing_optimize | Suggests optimal price points based on margin analysis, sales velocity, and configurable pricing rules. | | customers_segment | Performs RFM analysis and assigns customers to one of seven segments. | | customers_churn | Scores customers for churn risk and provides retention recommendations. | | order_anomalies | Detects potentially fraudulent or erroneous orders using pattern-recognition models. | | product_performance | Conducts ABC analysis and returns contribution metrics per product class. | | report_daily | Generates a JSON/CSV daily operations summary (sales, inventory, alerts). | | report_weekly | Generates a weekly performance report with trend visualisations. |

MCP Resources

| Resource | Description | |----------|-------------| | store://overview | High-level store metrics: total sales, orders, customers, and gross margin. | | store://inventory | Full inventory catalogue with quantity on hand, reserved stock and forecasted shortages. | | store://orders/recent | List of the most recent 100 orders with status, total value and payment method. | | store://customers/top | Top 50 customers ranked by lifetime value, purchase frequency and recency. |

Configuration

Create a .env file at the project root. The following variables are required:

| Variable | Required for | Description | |----------|--------------|-------------| | SHOPIFY_API_KEY | Shopify | Private app API key. | | SHOPIFY_API_PASSWORD | Shopify | Private app password. | | SHOPIFY_STORE_DOMAIN | Shopify | Store domain (e.g., myshop.myshopify.com). | | WOOCOMMERCE_CONSUMER_KEY | WooCommerce | REST API consumer key. | | WOOCOMMERCE_CONSUMER_SECRET | WooCommerce | REST API consumer secret. | | WOOCOMMERCE_STORE_URL | WooCommerce | Store URL (e.g., https://example.com). | | MCP_PORT | HTTP transport | Port for the Streamable HTTP endpoint (default 8080). | | MCP_LOG_LEVEL | All | Logging verbosity (error, warn, info, debug). | | MCP_PRICING_MODEL | Pricing tools | Pricing strategy (margin_based). | | MCP_FORECAST_WINDOW_DAYS | Inventory forecast | Number of days to forecast (default 30). |

Optional variables:

| Variable | Description | |----------|-------------| | MCP_ENABLE_ANONYMIZATION | When set to true, personally identifiable data is masked in reports. | | MCP_REPORT_S3_BUCKET | If provided, daily/weekly reports are uploaded to the specified S3 bucket. |

Pro License

ShopOps ships in Free mode — store_demo_seed, store_connect, inventory_status, pricing_analyze, customers_segment, product_performance, and report_daily are open. The following tools require a Pro license:

• inventory_forecast — moving-average demand forecasting + reorder points
• pricing_optimize — actionable price-change recommendations
• customers_churn — churn risk scoring + retention recommendations
• order_anomalies — fraud / anomaly detection
• report_weekly — week-over-week trend report + AI insights

Buy a Pro License (€29, lifetime, 3 machines): https://automatiabcn.lemonsqueezy.com/buy/cbbe44f0-a146-4c65-88c8-71f371037758

Or get the Indie MCP Stack Bundle (€69, all 4 servers).

export LEMONSQUEEZY_LICENSE_KEY=YOUR-KEY-HERE

Or in your MCP client config:

{
  "mcpServers": {
    "shopops-mcp": {
      "command": "npx",
      "args": ["-y", "shopops-mcp-server"],
      "env": { "LEMONSQUEEZY_LICENSE_KEY": "YOUR-KEY-HERE" }
    }
  }
}

Validation is cached locally for 24 h — fully offline-capable after first run.

License

ShopOps MCP is released under the MIT License. See LICENSE for full terms.

Author: Automatia BCN