{"_id":"@ainative/commerce-mcp","name":"@ainative/commerce-mcp","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@ainative/commerce-mcp","version":"0.1.0","description":"MCP server for ZeroCommerce — manage products, orders, customers, analytics, and storefronts through any MCP-compatible AI client.","main":"dist/index.js","module":"dist/index.mjs","types":"dist/index.d.ts","bin":{"commerce-mcp":"dist/cli.js"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.mjs","require":"./dist/index.js"},"./tools/catalog":{"types":"./dist/tools/catalog.d.ts","import":"./dist/tools/catalog.mjs","require":"./dist/tools/catalog.js"},"./tools/orders":{"types":"./dist/tools/orders.d.ts","import":"./dist/tools/orders.mjs","require":"./dist/tools/orders.js"},"./tools/customers":{"types":"./dist/tools/customers.d.ts","import":"./dist/tools/customers.mjs","require":"./dist/tools/customers.js"},"./tools/analytics":{"types":"./dist/tools/analytics.d.ts","import":"./dist/tools/analytics.mjs","require":"./dist/tools/analytics.js"},"./tools/storefront":{"types":"./dist/tools/storefront.d.ts","import":"./dist/tools/storefront.mjs","require":"./dist/tools/storefront.js"}},"scripts":{"build":"tsup","dev":"tsup --watch","test":"vitest run","test:watch":"vitest","test:coverage":"vitest run --coverage","prepublishOnly":"npm run build && npm test"},"keywords":["ecommerce-mcp","commerce-mcp","zerocommerce","ai-commerce","agentic-commerce","mcp","model-context-protocol","mcp-server","ecommerce","ai-shopping","storefront","product-management","order-management","commerce-api","ainative","zeromemory","headless-commerce","ai-agent","commerce-automation"],"author":{"name":"AINative Studio","email":"dev@ainative.studio"},"license":"MIT","homepage":"https://ainative.studio/commerce","repository":{"type":"git","url":"git+https://github.com/AINative-Studio/commerce-mcp.git"},"bugs":{"url":"https://github.com/AINative-Studio/commerce-mcp/issues"},"devDependencies":{"@types/node":"^26.0.1","@vitest/coverage-v8":"^4.0.0","tsup":"^8.0.0","typescript":"^5.2.2","vitest":"^4.0.0"},"engines":{"node":">=18.0.0"},"_id":"@ainative/commerce-mcp@0.1.0","_nodeVersion":"22.21.0","_npmVersion":"10.9.4","dist":{"integrity":"sha512-Obpt6tIOGmhispjAKp2xexWYovWYbKZ+got5bFYkppLTzzM5xfQu4Lm2riBFfO3DSZTBsq+e5JXxs4yQFIg9zQ==","shasum":"74ef13009d11824d50052f38f912a7fec2c742b8","tarball":"https://registry.npmjs.org/@ainative/commerce-mcp/-/commerce-mcp-0.1.0.tgz","fileCount":46,"unpackedSize":642971,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIBLAk1RcDz4fZfVNTNtAzl/bdBx/azuN3hn74SRVg2SUAiEAtFcQoE7VFbBIVoAyerP36fD6Lpvj2UjPuYw7zUiCT38="}]},"_npmUser":{"name":"ainative-studio","email":"toby@rely.ventures"},"directories":{},"maintainers":[{"name":"ainative-studio","email":"toby@rely.ventures"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/commerce-mcp_0.1.0_1782428597645_0.07377607856019197"},"_hasShrinkwrap":false}},"time":{"created":"2026-06-25T23:03:17.506Z","0.1.0":"2026-06-25T23:03:17.786Z","modified":"2026-06-25T23:03:18.005Z"},"maintainers":[{"name":"ainative-studio","email":"toby@rely.ventures"}],"description":"MCP server for ZeroCommerce — manage products, orders, customers, analytics, and storefronts through any MCP-compatible AI client.","homepage":"https://ainative.studio/commerce","keywords":["ecommerce-mcp","commerce-mcp","zerocommerce","ai-commerce","agentic-commerce","mcp","model-context-protocol","mcp-server","ecommerce","ai-shopping","storefront","product-management","order-management","commerce-api","ainative","zeromemory","headless-commerce","ai-agent","commerce-automation"],"repository":{"type":"git","url":"git+https://github.com/AINative-Studio/commerce-mcp.git"},"author":{"name":"AINative Studio","email":"dev@ainative.studio"},"bugs":{"url":"https://github.com/AINative-Studio/commerce-mcp/issues"},"license":"MIT","readme":"# @ainative/commerce-mcp\n\nMCP server for [ZeroCommerce](https://zerocommerce-production.up.railway.app) -- manage products, orders, customers, analytics, and storefronts through any MCP-compatible AI client.\n\n46 tools across 6 categories, mirroring the full ZeroCommerce REST API.\n\n## Install\n\n```bash\nnpm install @ainative/commerce-mcp\n```\n\n## Quick Start\n\n### As a library\n\n```typescript\nimport { ZeroCommerceMCP } from '@ainative/commerce-mcp';\n\nconst mcp = new ZeroCommerceMCP({\n  apiUrl: process.env.ZEROCOMMERCE_API_URL,\n  apiKey: process.env.ZEROCOMMERCE_API_KEY,\n  storeSlug: 'my-store',\n});\n\n// List products\nconst products = await mcp.catalog.listProducts();\n\n// Get order details\nconst order = await mcp.orders.getOrder('order-123');\n\n// Revenue summary\nconst revenue = await mcp.analytics.getRevenueSummary(30);\n\n// Execute any tool by name\nconst result = await mcp.executeTool('list_products', {\n  store_slug: 'my-store',\n  limit: 10,\n});\n```\n\n### As a CLI\n\n```bash\n# List available tools\nnpx @ainative/commerce-mcp --store my-store --list-tools\n\n# Execute a tool\nnpx @ainative/commerce-mcp --store my-store --tool list_products --limit 10\n\n# With explicit API key\nnpx @ainative/commerce-mcp --store my-store --api-key zc_... --tool get_revenue_summary --days 7\n```\n\n### Claude Code / Cursor MCP config\n\n```json\n{\n  \"mcpServers\": {\n    \"commerce\": {\n      \"command\": \"npx\",\n      \"args\": [\"@ainative/commerce-mcp\", \"--store\", \"my-store\"],\n      \"env\": {\n        \"ZEROCOMMERCE_API_URL\": \"https://zerocommerce-production.up.railway.app\",\n        \"ZEROCOMMERCE_API_KEY\": \"your-api-key\"\n      }\n    }\n  }\n}\n```\n\n## Environment Variables\n\n| Variable | Description | Default |\n|----------|-------------|---------|\n| `ZEROCOMMERCE_API_URL` | ZeroCommerce API base URL | `https://zerocommerce-production.up.railway.app` |\n| `ZEROCOMMERCE_API_KEY` | API key for authentication | -- |\n| `ZEROCOMMERCE_STORE` | Default store slug | -- |\n| `AINATIVE_API_KEY` | AINative API key for ZeroMemory integration | -- |\n\n## Tool Categories\n\n### Catalog (12 tools)\n\n| Tool | Description |\n|------|-------------|\n| `list_products` | List products with prices, stock, and IDs |\n| `get_product` | Get full product details by ID |\n| `create_product` | Create a new product |\n| `update_product` | Update product fields |\n| `delete_product` | Permanently delete a product |\n| `search_products_semantic` | Natural language product search |\n| `update_stock` | Set absolute stock level |\n| `adjust_stock` | Adjust stock by a relative amount |\n| `bulk_update_prices` | Update prices for multiple products |\n| `activate_product` | Make product visible in storefront |\n| `deactivate_product` | Hide product from storefront |\n| `duplicate_product` | Clone an existing product |\n\n### Orders (10 tools)\n\n| Tool | Description |\n|------|-------------|\n| `list_orders` | List orders, filter by status |\n| `get_order` | Get full order details |\n| `update_order_status` | Change order status |\n| `cancel_order` | Cancel an order |\n| `refund_order` | Issue full or partial refund |\n| `add_tracking` | Add shipping tracking info |\n| `list_orders_by_customer` | Orders by customer email |\n| `get_order_analytics` | Order statistics for a period |\n| `export_orders_csv` | Export orders as CSV |\n| `search_orders` | Search orders by customer |\n\n### Customers (6 tools)\n\n| Tool | Description |\n|------|-------------|\n| `list_customers` | List customers with order stats |\n| `get_customer` | Customer profile with history |\n| `get_customer_lifetime_value` | Calculate customer LTV |\n| `search_customers` | Search by name or email |\n| `get_top_customers` | Top customers by spend |\n| `export_customers_csv` | Export customer data |\n\n### Analytics (8 tools)\n\n| Tool | Description |\n|------|-------------|\n| `get_revenue_summary` | Revenue, orders, AOV, top products |\n| `get_top_products` | Best sellers by revenue |\n| `get_conversion_funnel` | Cart-to-order conversion metrics |\n| `get_revenue_by_day` | Daily revenue breakdown |\n| `get_inventory_status` | Inventory health overview |\n| `get_recent_activity` | Latest store events |\n| `get_store_health` | Store health score |\n| `compare_periods` | Compare two time periods |\n\n### Storefront & Config (10 tools)\n\n| Tool | Description |\n|------|-------------|\n| `get_storefront_url` | Public storefront URL |\n| `preview_storefront` | Current storefront state |\n| `set_featured_products` | Set homepage featured products |\n| `get_inventory_alerts` | Low-stock product alerts |\n| `get_store_info` | Store settings and config |\n| `update_store_settings` | Update store settings |\n| `get_webhooks` | List webhook subscriptions |\n| `create_webhook` | Register a new webhook |\n| `delete_webhook` | Remove a webhook |\n| `get_api_keys` | List API keys (masked) |\n\n## Programmatic API\n\n```typescript\nimport { ZeroCommerceMCP, ZeroCommerceClient, ApiError } from '@ainative/commerce-mcp';\n\n// Use the client directly for lower-level access\nconst client = new ZeroCommerceClient({\n  apiUrl: 'https://zerocommerce-production.up.railway.app',\n  apiKey: 'your-key',\n});\n\ntry {\n  const data = await client.get('/api/v1/products/', {\n    store_slug: 'my-store',\n    limit: 5,\n  });\n  console.log(data);\n} catch (err) {\n  if (err instanceof ApiError) {\n    console.error(`API Error ${err.status}: ${err.message}`);\n  }\n}\n```\n\n## License\n\nMIT\n","readmeFilename":"README.md","_rev":"1-e52369c71020c27fa2c0c4b6f5432d0b"}