Shopops Mcp

io.github.enzoemir1Published by GitHub account enzoemir1v1.2.2Updated Oct 24, 2026

AI e-commerce operations. Inventory, pricing, segmentation, and analytics.

VerifiedSTDIODesktop onlyData & AnalyticsBusiness & Commerce

Overview

AI-generated overview

Local MCP server that connects an assistant to Shopify and WooCommerce stores for inventory, pricing, customer segmentation, order checks and reports.

What you can do
Connect, list, disconnect and sync Shopify or WooCommerce stores, or seed a demo store with sample data to explore without real credentials. Check stock levels, back-order flags and low-stock alerts, and forecast future inventory needs. Analyze price elasticity and suggest optimized price points from margin and sales velocity. Segment customers by RFM, score churn risk and recommend retention actions. Detect anomalous or possibly fraudulent orders and run ABC analysis of product performance. Generate daily and weekly operations reports, and read store overview, inventory, recent orders and top customers as resources.
When to use it
Useful when an assistant should help run a Shopify or WooCommerce shop: reviewing stock, testing pricing ideas, segmenting customers, flagging suspicious orders or producing recurring sales and inventory reports. The demo seed makes it easy to try before connecting a real store.
Requirements
Runs locally as a Node.js process installed from npm (shopops-mcp). Store credentials are passed at runtime to the store_connect tool: a Shopify store domain and access token, or a WooCommerce store URL with consumer key and consumer secret. Optional environment variables PORT and MCPIZE switch it to an HTTP endpoint; LEMONSQUEEZY_LICENSE_KEY unlocks the Pro tier.
Before you install
Store credentials (Shopify access token, WooCommerce consumer key and secret) are passed as tool parameters, so they appear in the conversation and tool calls. The server can sync and read live store data, which is sent to the assistant and its model provider. A paid Pro license is offered; the free tier works without a license key. Report anonymization and export features are listed as roadmap, not implemented.

Installation

In SourceWeft

  1. Open Shopops Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

ShopOps MCP

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

[License: MIT] [TypeScript] [MCP]

Features

  • Store connectors for Shopify and WooCommerce.
  • 12 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 a €29 lifetime Pro license.

Quick Start

bash
# 1. Install the packagenpm 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

ToolDescription
store_connectConnects, lists, disconnects, or syncs a Shopify/WooCommerce store (action: "connect" | "list" | "disconnect" | "sync") and validates credentials.
store_demo_seedCreates a realistic demo store (20 products, 40 customers, 150+ orders) so you can explore every tool without real store credentials.
inventory_statusReturns current stock levels, back-order flags and low-stock alerts.
inventory_forecastProjects future inventory requirements using moving-average demand and safety-stock buffers.
pricing_analyzeGenerates a price elasticity report and identifies under-/over-priced SKUs.
pricing_optimizeSuggests optimal price points based on margin analysis, sales velocity, and configurable pricing rules.
customers_segmentPerforms RFM analysis and assigns customers to one of seven segments.
customers_churnScores customers for churn risk and provides retention recommendations.
order_anomaliesDetects potentially fraudulent or erroneous orders using pattern-recognition models.
product_performanceConducts ABC analysis and returns contribution metrics per product class.
report_dailyGenerates a JSON/CSV daily operations summary (sales, inventory, alerts).
report_weeklyGenerates a weekly performance report with trend visualisations.

MCP Resources

ResourceDescription
store://overviewHigh-level store metrics: product, order, and customer counts per connected store.
store://inventoryLow-stock alerts: active products with on-hand quantity ≤ 10, sorted lowest first.
store://orders/recentThe 20 most recent orders across all stores, with order number, total, status and date.
store://customers/topTop 20 customers by total spending, with name, email and order count.

Configuration

ShopOps reads only a handful of environment variables. Store credentials are not env vars — they are passed to the store_connect tool at runtime (one connection per store), so the same server process can manage multiple Shopify/WooCommerce stores.

VariableRequiredDescription
PORTNoIf set (or MCPIZE=true), the server runs as a Streamable HTTP endpoint on this port (default 8080) instead of local stdio.
MCPIZENoSet to true by the MCPize runtime to force HTTP transport.
LEMONSQUEEZY_LICENSE_KEYNoPro license key. Without it the server runs in Free tier (see Pro License).

A minimal .env is provided in .env.example.

Connecting a store

Shopify and WooCommerce credentials are supplied as parameters to store_connect, e.g.:

jsonc
// Shopify{ "action": "connect", "platform": "shopify",  "store_domain": "myshop.myshopify.com", "access_token": "shpat_..." }
// WooCommerce{ "action": "connect", "platform": "woocommerce",  "store_url": "https://example.com", "consumer_key": "ck_...", "consumer_secret": "cs_..." }

store_connect returns a store_id that every other tool takes as input. To explore the server without real credentials, call store_demo_seed instead.

Roadmap (not yet implemented): report anonymization, S3 report export, and a configurable pricing-model / log-level are planned but not read by the current release.

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).

bash
export LEMONSQUEEZY_LICENSE_KEY=YOUR-KEY-HERE

Or in your MCP client config:

json
{  "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

Source: README.md at commit 14da807

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.2.2LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts