mcp-ecom-hub

MCP server for Shopify e-commerce operations — read + write, multi-store native.

Existing Shopify MCP servers are read-only. mcp-ecom-hub fills the gap: write ops, bulk price updates, fulfillments, discounts, analytics — all via natural language through any MCP client.

Quick Start

npm install -g mcp-ecom-hub

Configure your store

Copy the example config and add your Shopify credentials:

cp config/stores.example.json config/stores.json

{
  "stores": [
    {
      "id": "mystore",
      "name": "My Store",
      "shopify": {
        "domain": "my-store.myshopify.com",
        "accessToken": "shpat_xxxxxxxxxxxx"
      }
    }
  ],
  "defaultStore": "mystore"
}

Add to your MCP client

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "ecom-hub": {
      "command": "npx",
      "args": ["mcp-ecom-hub"]
    }
  }
}

Claude Code:

claude mcp add ecom-hub npx mcp-ecom-hub

Tools (v0.1.0 — Shopify)

| Tool | Description | |------|-------------| | shopify_get_orders | List/filter orders with auto-pagination | | shopify_get_products | List products with variants, prices, inventory | | shopify_update_product | Update title, description, status, tags | | shopify_bulk_update_prices | Bulk price update (max 100 variants/call) | | shopify_create_discount | Create price rules + discount codes | | shopify_get_analytics | Revenue, AOV, items sold (paginated for accuracy) | | shopify_fulfill_order | Fulfill via modern FulfillmentOrder API | | shopify_get_fulfillment_orders | Inspect fulfillment orders before fulfilling | | shopify_cancel_order | Cancel order (requires confirm: true) | | shopify_get_customers | Customer list with order count + total spent |

Safety

• Destructive operations (cancel_order) require confirm: true
• Prices validated as non-negative numbers
• Bulk operations capped at 100 items per call
• API errors sanitized — no raw response bodies leaked
• Rate limiting with exponential backoff on 429

Multi-store

All tools accept an optional storeId parameter. Configure multiple stores in config/stores.json and switch between them per-call.

Roadmap

• [x] Shopify read + write ops (v0.1.0)
• [ ] Stripe revenue tools (v0.2.0)
• [ ] Multi-store dashboard (v0.3.0)

License

MIT