{
  "markdown": "# ShopOps MCP\n\n**AI-powered server that implements the Model Context Protocol (MCP) for managing Shopify and WooCommerce stores.**\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)\n[![TypeScript](https://img.shields.io/badge/TypeScript-5.x-3178C6.svg)](https://www.typescriptlang.org/)\n[![MCP](https://img.shields.io/badge/MCP-1.29-2A9D8F.svg)](https://modelcontextprotocol.io/)\n\n---\n\n## Features\n\n- **Store connectors** for Shopify and WooCommerce.\n- **12 MCP tools** covering inventory, pricing, customers, orders, product performance and reporting.\n- **4 MCP resources** exposing store overview, inventory, recent orders and top customers.\n- Inventory forecasting using moving-average demand plus safety-stock calculation.\n- RFM-based customer segmentation (7 distinct segments).\n- Data-driven pricing analysis with margin-based optimization suggestions.\n- Order anomaly / fraud detection.\n- ABC analysis of product performance.\n- Automated daily and weekly reports.\n- Dual transport: local `stdio` and Streamable HTTP (MCPize).\n- TypeScript, `@modelcontextprotocol/sdk` v1.29+, Zod v4.\n- Free tier, plus a €29 lifetime Pro license.\n\n---\n\n## Quick Start\n\n```bash\n# 1. Install the package\nnpm i shopops-mcp\n\n# 2. Create a .env file (see Configuration section)\ncp .env.example .env\n\n# 3. Run the server (local stdio mode)\nnpx shopops-mcp run --transport stdio\n\n# 4. Or start the HTTP endpoint (MCPize deployment)\nnpx shopops-mcp run --transport http --port 8080\n```\n\nThe server will read the environment variables, connect to the configured store(s), and expose the MCP tools and resources.\n\n---\n\n## MCP Tools\n\n| Tool | Description |\n|------|-------------|\n| `store_connect` | Connects, lists, disconnects, or syncs a Shopify/WooCommerce store (`action: \"connect\" \\| \"list\" \\| \"disconnect\" \\| \"sync\"`) and validates credentials. |\n| `store_demo_seed` | Creates a realistic demo store (20 products, 40 customers, 150+ orders) so you can explore every tool without real store credentials. |\n| `inventory_status` | Returns current stock levels, back-order flags and low-stock alerts. |\n| `inventory_forecast` | Projects future inventory requirements using moving-average demand and safety-stock buffers. |\n| `pricing_analyze` | Generates a price elasticity report and identifies under-/over-priced SKUs. |\n| `pricing_optimize` | Suggests optimal price points based on margin analysis, sales velocity, and configurable pricing rules. |\n| `customers_segment` | Performs RFM analysis and assigns customers to one of seven segments. |\n| `customers_churn` | Scores customers for churn risk and provides retention recommendations. |\n| `order_anomalies` | Detects potentially fraudulent or erroneous orders using pattern-recognition models. |\n| `product_performance` | Conducts ABC analysis and returns contribution metrics per product class. |\n| `report_daily` | Generates a JSON/CSV daily operations summary (sales, inventory, alerts). |\n| `report_weekly` | Generates a weekly performance report with trend visualisations. |\n\n---\n\n## MCP Resources\n\n| Resource | Description |\n|----------|-------------|\n| `store://overview` | High-level store metrics: product, order, and customer counts per connected store. |\n| `store://inventory` | Low-stock alerts: active products with on-hand quantity ≤ 10, sorted lowest first. |\n| `store://orders/recent` | The 20 most recent orders across all stores, with order number, total, status and date. |\n| `store://customers/top` | Top 20 customers by total spending, with name, email and order count. |\n\n---\n\n## Configuration\n\nShopOps reads only a handful of environment variables. **Store credentials are not env vars** —\nthey are passed to the `store_connect` tool at runtime (one connection per store), so the same\nserver process can manage multiple Shopify/WooCommerce stores.\n\n| Variable | Required | Description |\n|----------|----------|-------------|\n| `PORT` | No | If set (or `MCPIZE=true`), the server runs as a Streamable HTTP endpoint on this port (default `8080`) instead of local `stdio`. |\n| `MCPIZE` | No | Set to `true` by the MCPize runtime to force HTTP transport. |\n| `LEMONSQUEEZY_LICENSE_KEY` | No | Pro license key. Without it the server runs in Free tier (see [Pro License](#pro-license)). |\n\nA minimal `.env` is provided in [`.env.example`](.env.example).\n\n### Connecting a store\n\nShopify and WooCommerce credentials are supplied as parameters to `store_connect`, e.g.:\n\n```jsonc\n// Shopify\n{ \"action\": \"connect\", \"platform\": \"shopify\",\n  \"store_domain\": \"myshop.myshopify.com\", \"access_token\": \"shpat_...\" }\n\n// WooCommerce\n{ \"action\": \"connect\", \"platform\": \"woocommerce\",\n  \"store_url\": \"https://example.com\", \"consumer_key\": \"ck_...\", \"consumer_secret\": \"cs_...\" }\n```\n\n`store_connect` returns a `store_id` that every other tool takes as input. To explore the server\nwithout real credentials, call `store_demo_seed` instead.\n\n> **Roadmap (not yet implemented):** report anonymization, S3 report export, and a configurable\n> pricing-model / log-level are planned but not read by the current release.\n\n---\n\n## Pro License\n\nShopOps 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**:\n\n- `inventory_forecast` — moving-average demand forecasting + reorder points\n- `pricing_optimize` — actionable price-change recommendations\n- `customers_churn` — churn risk scoring + retention recommendations\n- `order_anomalies` — fraud / anomaly detection\n- `report_weekly` — week-over-week trend report + AI insights\n\n**Buy a Pro License (€29, lifetime, 3 machines):** https://automatiabcn.lemonsqueezy.com/buy/cbbe44f0-a146-4c65-88c8-71f371037758\n\nOr get the **[Indie MCP Stack Bundle](https://automatiabcn.lemonsqueezy.com/buy/55e932fd-8319-47f0-8e95-0b86a29f2617)** (€69, all 4 servers).\n\n```bash\nexport LEMONSQUEEZY_LICENSE_KEY=YOUR-KEY-HERE\n```\n\nOr in your MCP client config:\n\n```json\n{\n  \"mcpServers\": {\n    \"shopops-mcp\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"shopops-mcp-server\"],\n      \"env\": { \"LEMONSQUEEZY_LICENSE_KEY\": \"YOUR-KEY-HERE\" }\n    }\n  }\n}\n```\n\nValidation is cached locally for 24 h — fully offline-capable after first run.\n\n---\n\n## License\n\nShopOps MCP is released under the **MIT License**. See [LICENSE](LICENSE) for full terms.\n\n---\n\n*Author: Automatia BCN*\n",
  "bytes": 6431,
  "sha": "09212e53c70d88a8fa40756a88e57a0fd5e6fa389b2d0136ea0d8146112273be",
  "repo_slug": "enzoemir1/shopops-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_enzoemir1_shopops_mcp_0ebc7ebc/readme"
}