@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 — manage products, orders, customers, coupons, payment links, subscriptions, tickets, licenses, blacklist, analytics, and more. 51 tools, 5 resources, 6 workflow prompts.

Install

The fastest way is the one-shot installer:

npx @shoppexio/mcp-shoppex install --api-key shx_your_dev_api_key

That installs both commerce and theme MCPs. Or install commerce standalone:

npm install -g @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.

Cursor / Windsurf / Claude Code

Any MCP client with stdio transport works. Set the same env var and point to shoppex-mcp-commerce-server as the command — or use the @shoppexio/cli helper: shoppex mcp install --client cursor|windsurf|claude-code.

Tools (51)

Products

• products_list — search or list products
• products_get — fetch one by id/uniqid
• products_create — create (service, serials, dynamic, file)
• products_update — price, title, gateways, stock, visibility
• products_delete — soft-delete
• products_duplicate — clone
• products_upload_serials — bulk-add license keys

Orders

• orders_list — list, filter by status/email
• orders_get — fetch one with line items
• orders_update — notes, internal notes
• orders_fulfill — mark delivered

Customers

• customers_list — list with filter expressions
• customers_get — fetch by id or email
• customers_wallet_credit — credit wallet balance

Invoices

• invoices_list — filter by status, customer
• invoices_get — fetch one

Coupons

• coupons_list — list active
• coupons_get — fetch one
• coupons_create — percentage or fixed
• coupons_update — update any field
• coupons_delete — remove

Payment Links

• payment_links_list / _get / _update / _delete / _toggle
• payment_links_create — one-click checkout URLs

Categories

• categories_list / _create / _update

Webhooks

• webhooks_list / _create

Tickets (support inbox)

• tickets_list / _get / _create / _reply / _close

Disputes

• disputes_list / _get

Licenses

• licenses_list / _get / _update (revoke/extend/reset HWID locks)

Subscriptions

• subscriptions_list / _cancel

Affiliates

• affiliates_list

Blacklist

• blacklist_list / _add / _remove

Analytics

• analytics_revenue — revenue totals
• analytics_reports_list — custom reports
• analytics_report_generate — re-generate a report

Resources (5)

Claude Desktop surfaces these as attachable context documents. Drag them into any chat to ground the conversation in live shop data:

| URI | What | |------|------| | shoppex://products | Full product catalog with variants | | shoppex://orders/recent | Last 50 orders | | shoppex://analytics/summary | MTD revenue snapshot | | shoppex://categories | Category tree | | shoppex://tickets/open | Open support tickets |

Prompts (6)

Pre-built workflows available as slash commands:

| Prompt | What it does | |--------|--------------| | /shoppex_daily_brief | Morning summary: revenue, orders, attention items | | /shoppex_launch_product | End-to-end product launch (args: product_name, price) | | /shoppex_fraud_check | Suspicious-orders scan + blacklist suggestions | | /shoppex_weekly_recap | 7-day performance recap | | /shoppex_customer_care | Full customer timeline + draft reply (args: email) | | /shoppex_theme_refresh | Active-theme structural review |

Example prompts

• "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."
• "Refund customer [email protected] for invoice inv_xyz."
• "Are there any fraud patterns in the last 48h?"
• /shoppex_daily_brief

Environment Variables

| Variable | Required | Default | |----------|----------|---------| | SHOPPEX_SHOP_API_KEY | yes (or passed per call) | — | | SHOPPEX_API_BASE_URL | no | https://api.shoppex.io | | SHOPPEX_DEV_API_TIMEOUT_MS | no | 10000 |

Create an API key at dashboard.shoppex.io/developer/api.

Companion

Pair with @shoppexio/mcp-theme-server for storefront theme operations including theme_ai_apply (natural-language theme editing).

Agent Templates

Paste-ready agent personalities (customer care, product launch, fraud investigator, analyst, theme editor): docs/agents/

Docs

• Developer API Reference
• Quickstart
• Authentication

License

Proprietary. © Shoppex.