# CommerceWeave MCP

> CommerceWeave MCP is an open-source MCP server for e-commerce. Local MCP server for Allegro, Base.com and WooCommerce with human-approved writes. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Repository:** https://github.com/mysterekkk/commerceweave-mcp
- **MCP Registry name:** io.github.mysterekkk/commerceweave-mcp
- **Categories:** [e-commerce](https://ai-powered.com/categories/e-commerce)
- **Listing updated:** 2026-11-18

## About

Stores on Allegro, Base.com (BaseLinker) and WooCommerce are exposed through one set of commerce_* tools, with products and orders normalised so each platform id is kept. The README says imported orders are de-duplicated, so an Allegro order imported into Base is not counted twice, currencies are never mixed, revenue is never called profit, and each result says when it is incomplete.

Writes are gated by COMMERCEWEAVE_MODE. The default is read_only, where no write tool is registered at all. In proposal mode the model can prepare before/after plans for stock, price, order status, order notes, offer publication and product drafts, and in approval_required mode a plan runs only after you type its code into your own terminal with the approve command. Approvals are single-use, expire after 15 minutes by default and are bound to the exact plan.

It runs on your machine over stdio via npx (an authenticated Streamable HTTP mode is optional), needs Node.js 22 or later, and has a demo mode with synthetic data that needs no credentials. The README is candid that it was validated against local servers that implement each platform's protocol, not yet against live accounts, and that dedicated single-platform servers cover more API methods. It is MIT licensed and made by LuroWeb.

## Features

- **Three platforms, one toolset:** Query Allegro, Base.com and WooCommerce through the same normalised products and orders.
- **Read-only by default:** No write tool is registered unless you change the mode.
- **Approved proposals:** Writes are before/after plans that run only after you approve a code in your own terminal.
- **Honest reporting:** Imported orders are de-duplicated and currencies are never mixed.
- **Demo mode:** Try it with synthetic data and no credentials.
- **Local credentials:** Runs over stdio on your machine; Allegro tokens can be encrypted with AES-256-GCM.

## Good for

- Show today's orders across all connected stores
- Find products running low on stock
- Find stock discrepancies between Base.com and WooCommerce
- Prepare a 5% price increase for review before applying
- Summarise last week's sales without double-counting imported orders

## Install

### Claude Code (Terminal)

```sh
claude mcp add commerceweave-mcp --env ALLEGRO_CLIENT_SECRET='<ALLEGRO_CLIENT_SECRET>' --env BASE_API_TOKEN='<BASE_API_TOKEN>' --env WOO_CONSUMER_KEY='<WOO_CONSUMER_KEY>' --env WOO_CONSUMER_SECRET='<WOO_CONSUMER_SECRET>' -- npx -y commerceweave-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "commerceweave-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "commerceweave-mcp"
      ],
      "env": {
        "ALLEGRO_CLIENT_SECRET": "<ALLEGRO_CLIENT_SECRET>",
        "BASE_API_TOKEN": "<BASE_API_TOKEN>",
        "WOO_CONSUMER_KEY": "<WOO_CONSUMER_KEY>",
        "WOO_CONSUMER_SECRET": "<WOO_CONSUMER_SECRET>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "commerceweave-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "commerceweave-mcp"
      ],
      "env": {
        "ALLEGRO_CLIENT_SECRET": "<ALLEGRO_CLIENT_SECRET>",
        "BASE_API_TOKEN": "<BASE_API_TOKEN>",
        "WOO_CONSUMER_KEY": "<WOO_CONSUMER_KEY>",
        "WOO_CONSUMER_SECRET": "<WOO_CONSUMER_SECRET>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "commerceweave-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "commerceweave-mcp"
      ],
      "env": {
        "ALLEGRO_CLIENT_SECRET": "<ALLEGRO_CLIENT_SECRET>",
        "BASE_API_TOKEN": "<BASE_API_TOKEN>",
        "WOO_CONSUMER_KEY": "<WOO_CONSUMER_KEY>",
        "WOO_CONSUMER_SECRET": "<WOO_CONSUMER_SECRET>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "commerceweave-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "commerceweave-mcp"
      ],
      "env": {
        "ALLEGRO_CLIENT_SECRET": "<ALLEGRO_CLIENT_SECRET>",
        "BASE_API_TOKEN": "<BASE_API_TOKEN>",
        "WOO_CONSUMER_KEY": "<WOO_CONSUMER_KEY>",
        "WOO_CONSUMER_SECRET": "<WOO_CONSUMER_SECRET>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "commerceweave-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "commerceweave-mcp"
      ],
      "env": {
        "ALLEGRO_CLIENT_SECRET": "<ALLEGRO_CLIENT_SECRET>",
        "BASE_API_TOKEN": "<BASE_API_TOKEN>",
        "WOO_CONSUMER_KEY": "<WOO_CONSUMER_KEY>",
        "WOO_CONSUMER_SECRET": "<WOO_CONSUMER_SECRET>"
      }
    }
  }
}
```

## Tools

- `get_proposal`: Shows a prepared write plan with its before and after values.
- `execute_proposal`: Runs a prepared plan once it has been approved in the terminal.

## FAQ

### Can the model change my shop on its own?

No. Read-only is the default, and in approval_required mode a plan runs only after you approve it with a code in your own terminal.

### Can I try it without accounts?

Yes, set COMMERCEWEAVE_DEMO=true to use synthetic data.

### Has it been tested on live stores?

The README says it was validated against local servers implementing each platform's documented protocol, not yet against live accounts.

### What is the licence?

MIT.

### What does it need to run?

Node.js 22 or later, started with npx commerceweave-mcp.

### Is CommerceWeave MCP free?

Yes. CommerceWeave MCP is open source, so you can use and self-host it for free.

### How do I add CommerceWeave MCP to Claude Code?

Run this command in your terminal: claude mcp add commerceweave-mcp --env ALLEGRO_CLIENT_SECRET='<ALLEGRO_CLIENT_SECRET>' --env BASE_API_TOKEN='<BASE_API_TOKEN>' --env WOO_CONSUMER_KEY='<WOO_CONSUMER_KEY>' --env WOO_CONSUMER_SECRET='<WOO_CONSUMER_SECRET>' -- npx -y commerceweave-mcp

### What are the best alternatives to CommerceWeave MCP?

The closest alternatives to CommerceWeave MCP are ChatGPT for Amazon, O'So MCP Server for PrestaShop, Ebid, Trackkr MCP Server — Smart Lockerless Parcel Management and Zovo Product Recall Check.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [ChatGPT for Amazon](https://ai-powered.com/mcp/chatgpt_for_amazon): ChatGPT for Amazon is a freemium MCP server for marketing.
- [O'So MCP Server for PrestaShop](https://ai-powered.com/mcp/o-so-mcp-server-for-prestashop): O'So MCP Server for PrestaShop is an open-source MCP server for e-commerce.
- [Ebid](https://ai-powered.com/mcp/ebid): Ebid is a freemium MCP server for e-commerce.
- [Trackkr MCP Server — Smart Lockerless Parcel Management](https://ai-powered.com/mcp/trackkr-mcp-server-smart-lockerless-parcel-management): Trackkr MCP Server — Smart Lockerless Parcel Management is an MCP server for e-commerce.
- [Zovo Product Recall Check](https://ai-powered.com/mcp/zovo-product-recall-check): Zovo Product Recall Check is an MCP server for e-commerce.
- [Skybridge Ecommerce Example](https://ai-powered.com/mcp/skybridge-ecommerce-example): Skybridge Ecommerce Example is an open-source MCP server for e-commerce.
- [GoAI Moat Xiaohongshu Products](https://ai-powered.com/mcp/goai-moat-xiaohongshu-products): GoAI Moat Xiaohongshu Products is an MCP server for e-commerce.
- [GoAI Moat Tiktok Shop](https://ai-powered.com/mcp/goai-moat-tiktok-shop): GoAI Moat Tiktok Shop is an MCP server for e-commerce.

---
Source: https://ai-powered.com/mcp/commerceweave-mcp
