You deploy and run the MCP WooCommerce Server to automate WooCommerce data flows via the MCP protocol. It provides real-time access to orders, customers, coupons, products, and analytics while offering N8N-ready endpoints for workflow automation. Use it to connect your WooCommerce store to automation tools, dashboards, and custom workflows with reliable schema validation and production-ready security.

How to use

You will interact with the MCP server using three access patterns: standard MCP calls over HTTP/WebSocket/SSE, N8N-compatible endpoints for automation, and local development commands for testing. Use the HTTP endpoint to send JSON-RPC style requests to perform actions like listing tools, querying data, and executing operations. Use the N8N endpoints to enumerate available tools in a workflow-friendly format and to execute tools with N8N schema validation. Receive real-time updates and alerts via SSE or WebSocket as configured.

Typical workflows include validating revenue and customer analytics, running coupon usage analyses, managing products, and processing orders. For production deployments, you will rely on the EasyPanel setup, environment variable configuration, and Docker-based builds to ensure consistent behavior across environments.

How to install

# Prerequisites
node --version
npm --version
Docker --version

# 1. Install dependencies (local dev)
npm install

# 2. Configure environment (copy example and edit)
cp .env.example .env
# Edit .env with your WooCommerce credentials and settings

# 3. Build and start the server
npm run build
npm start

# 4. Test MCP endpoints
curl http://localhost:3001/health
curl http://localhost:3001/mcp -X POST -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/list","id":1}'

# 5. Test N8N endpoints
curl http://localhost:3001/n8n/tools

"},{"type":"code","text":"```bash

EasyPanel deployment (production readiness)

1. Configure Cloudflare (optional)

npm run setup:cloudflare

2. Set environment variables in EasyPanel

WOOCOMMERCE_URL=https://your-store.com WOOCOMMERCE_KEY=ck_your_consumer_key WOOCOMMERCE_SECRET=cs_your_consumer_secret NODE_ENV=production PORT=3001

3. Deploy with Docker

docker build -t mcp-woocommerce-server .

"}]}]},{

Additional notes: The server exposes an HTTP MCP endpoint at http://localhost:3001/mcp, a WebSocket endpoint at ws://localhost:3001/mcp-ws, and SSE support at http://localhost:3001/mcp-sse. N8N-specific endpoints exist at /n8n/tools and /n8n/execute for workflow automation. The N8N integration provides schema-validated tool execution and real-time order and revenue events to drive automation scenarios.

Configuration and security basics

Security is addressed with authentication against WooCommerce OAuth credentials, Joi-based input validation, Helmet middleware, and CORS controls. Structured logging with Winston helps you monitor behavior and quickly diagnose issues.

Environment variables you should configure include the WooCommerce store URL, consumer key, consumer secret, node environment, and the port. Ensure your production environment enforces proper access controls and retries transient failures gracefully.

Troubleshooting and notes

If you encounter N8N compatibility errors, use the dedicated N8N endpoints to fetch tools and execute them with validated inputs. Ensure your environment passes the Joi schema checks and that you are using the N8N-compliant input structure when triggering tools.

You can verify real data operation by inspecting verified results in the analytics and revenue endpoints and by confirming that guest customers are included in analytics. Real-time data validation ensures responses reflect live WooCommerce data rather than demo data.

Available tools

wc_get_revenue_stats

Revenue statistics and related metrics (gross, net, discounts, etc.) across a period.

wc_get_order_stats

Order analytics, including counts, status breakdowns, and trends.

wc_get_customer_analytics

Customer insights such as lifetime value, segmentation, and activity.

wc_get_coupon_stats

Coupon performance analytics including usage and revenue impact.

wc_get_refund_stats

Refund analytics and impact on revenue.

wc_get_tax_reports

Tax reporting and compliance data.

wc_get_customers

Customer listing with details and filters.

wc_get_customer

Individual customer details.

wc_get_top_customers

Top spenders by revenue.

wc_create_customer

Create a new customer record.

wc_update_customer

Update an existing customer.

wc_delete_customer

Delete a customer.

wc_get_coupons

Coupon listing.

wc_get_coupon

Individual coupon details.

wc_get_coupon_by_code

Find a coupon by its code.

wc_get_coupon_usage_stats

Coupon usage analytics.

wc_get_top_coupons_usage

Most-used coupons.

wc_create_coupon

Create a new coupon.

wc_update_coupon

Update coupon details.

wc_delete_coupon

Delete a coupon.

wc_get_products

Product catalog.

wc_get_product

Product details.

wc_create_product

Create a new product.

wc_update_product

Update product details.

wc_delete_product

Delete a product.

wc_batch_products

Bulk product operations.

wc_get_orders

Order listing.

wc_get_order

Order details.

wc_create_order

Create a new order.

wc_update_order

Update order details.

wc_delete_order

Delete an order.