@shoppexio/mcp-commerce-server

Model Context Protocol server for Shoppex commerce operations.

Connect Claude Desktop, Claude Code, Cursor, Windsurf, or Codex to your Shoppex store. Read products, orders, customers, and analytics, create payment links, manage coupons, and create or update products — directly from chat.

Install

npm install -g @shoppexio/mcp-commerce-server

Or run without installing:

npx -y @shoppexio/mcp-commerce-server

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "shoppex-commerce": {
      "command": "npx",
      "args": ["-y", "@shoppexio/mcp-commerce-server"],
      "env": {
        "SHOPPEX_SHOP_API_KEY": "shx_your_dev_api_key"
      }
    }
  }
}

Restart Claude Desktop. Tools accept a shop_api_key argument on each call; the env var is available for clients that forward env to tool arguments.

Cursor / Windsurf / Other

Any MCP client with stdio transport works. Set the same env var and point to shoppex-mcp-commerce-server as the command.

Tools (12)

Read

| Tool | Purpose | |------|---------| | products.list | Search or list products | | products.get | Fetch one product by id or uniqid | | orders.list | List recent orders, optionally filtered | | orders.get | Fetch one order with line items | | customers.get | Fetch a customer by id or email | | coupons.list | List active coupons | | analytics.revenue | Revenue totals for a date range |

Write

| Tool | Purpose | |------|---------| | products.create | Create a product (service, serials, dynamic, file) | | products.update | Update a product's price, title, gateways, stock, visibility | | coupons.create | Create a coupon (percentage or fixed discount) | | coupons.update | Update an existing coupon | | payment_links.create | Create a payment link |

Required Scopes

Your Shoppex Dev API key needs the scopes matching the tools you use (e.g. products.read, products.write, orders.read, coupons.write, analytics.read, payment_links.write).

Create one at dashboard.shoppex.io/developer/api.

Environment Variables

| Variable | Required | Default | |----------|----------|---------| | SHOPPEX_SHOP_API_KEY | passed per call, or set here | — | | SHOPPEX_API_BASE_URL | no | https://api.shoppex.io | | SHOPPEX_DEV_API_TIMEOUT_MS | no | 10000 |

Example Prompts

Once connected in Claude Desktop:

• "Create a Discord Nitro 3-month product for $14.99 paid in crypto."
• "Show me this month's top 10 customers by revenue."
• "Generate a 20% off coupon for my Discord members, valid until end of month."
• "Update the price of product prd_abc123 to $12.99."
• "Make a payment link for a $50 USDT one-time purchase."

Companion

Pair with @shoppexio/mcp-theme-server for storefront theme operations.

Docs

• Developer API Reference
• Quickstart
• Authentication

License

Proprietary. © Shoppex.