zerocommerce-mcp 0.1.0

MCP server for ZeroCommerce — natural language commerce management

ZeroCommerce MCP Server

MCP server for ZeroCommerce — manage your store with natural language.

Quick Start

pip install zerocommerce-mcp

Set environment variables:

export ZEROCOMMERCE_API_URL=https://zerocommerce-production.up.railway.app
export ZEROCOMMERCE_API_KEY=your-api-key

Run the server:

zerocommerce-mcp

Claude Desktop Configuration

Add to ~/.claude/claude_desktop_config.json:

{
  "mcpServers": {
    "zerocommerce": {
      "command": "zerocommerce-mcp",
      "env": {
        "ZEROCOMMERCE_API_URL": "https://zerocommerce-production.up.railway.app",
        "ZEROCOMMERCE_API_KEY": "your-api-key"
      }
    }
  }
}

Tools (46)

Catalog (12)

• list_products — list products with prices and stock
• get_product — get full product details
• create_product — add a new product
• update_product — modify product fields
• delete_product — remove a product
• search_products_semantic — natural language product search
• update_stock — set absolute stock level
• adjust_stock — add/remove stock units
• bulk_update_prices — batch price updates
• activate_product — make product visible
• deactivate_product — hide product from storefront
• duplicate_product — clone a product

Orders (10)

• list_orders — list recent orders
• get_order — order details with line items
• update_order_status — change order status
• cancel_order — cancel with reason
• refund_order — full or partial refund
• add_tracking — add shipping tracking
• list_orders_by_customer — customer order history
• get_order_analytics — order statistics
• export_orders_csv — CSV export
• search_orders — search by email/name

Customers (6)

• list_customers — all customers with stats
• get_customer — customer profile + orders
• get_customer_lifetime_value — LTV calculation
• search_customers — search by name/email
• get_top_customers — ranked by spend
• export_customers_csv — CSV export

Analytics (8)

• get_revenue_summary — revenue totals and averages
• get_top_products — best sellers by revenue
• get_conversion_funnel — cart-to-order conversion
• get_revenue_by_day — daily breakdown
• get_inventory_status — stock health overview
• get_recent_activity — latest orders/events
• get_store_health — overall health score
• compare_periods — period-over-period comparison

Store Config (6)

• get_store_info — store settings
• update_store_settings — modify settings
• get_webhooks — list webhooks
• create_webhook — subscribe to events
• delete_webhook — remove webhook
• get_api_keys — list API keys (masked)

Storefront (4)

• get_storefront_url — public store URL
• preview_storefront — storefront state description
• set_featured_products — set featured product list
• get_inventory_alerts — low stock warnings