About io.github.enzoemir1/shopops-mcp
io.github.enzoemir1/shopops-mcp is an MCP server in the Commerce category: aI e-commerce operations. Inventory, pricing, segmentation, and analytics.
Install
claude mcp add io-github-enzoemir1-shopops-mcp -- npx -y shopops-mcp-servernpx -y shopops-mcp-serverThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (12)
customers_churnScores customers for churn risk and provides retention recommendations.
Parameters not published.
customers_segmentPerforms RFM analysis and assigns customers to one of seven segments.
Parameters not published.
inventory_forecastProjects future inventory requirements using moving-average demand and safety-stock buffers.
Parameters not published.
inventory_statusReturns current stock levels, back-order flags and low-stock alerts.
Parameters not published.
order_anomaliesDetects potentially fraudulent or erroneous orders using pattern-recognition models.
Parameters not published.
pricing_analyzeGenerates a price elasticity report and identifies under-/over-priced SKUs.
Parameters not published.
pricing_optimizeSuggests optimal price points based on margin analysis, sales velocity, and configurable pricing rules.
Parameters not published.
product_performanceConducts ABC analysis and returns contribution metrics per product class.
Parameters not published.
report_dailyGenerates a JSON/CSV daily operations summary (sales, inventory, alerts).
Parameters not published.
report_weeklyGenerates a weekly performance report with trend visualisations.
Parameters not published.
store_connectConnects, lists, disconnects, or syncs a Shopify/WooCommerce store (`action: "connect" \
Parameters not published.
store_demo_seedCreates a realistic demo store (20 products, 40 customers, 150+ orders) so you can explore every tool without real store credentials.
Parameters not published.
Ask AI
Ask AI about io.github.enzoemir1/shopops-mcp
Powered by Claude · Grounded in docs
Security checks
- ✓README presentThe repository ships documentation.
5 checks have not been run yet.
README
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
stdioand Streamable HTTP (MCPize). - TypeScript,
@modelcontextprotocol/sdkv1.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 pointspricing_optimize— actionable price-change recommendationscustomers_churn— churn risk scoring + retention recommendationsorder_anomalies— fraud / anomaly detectionreport_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
README copy captured when this server was indexed; it may lag the repository. The original is authoritative.