Skip to content
MCP server

CommerceWeave MCP

Local MCP server for Allegro, Base.com and WooCommerce with human-approved writes

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted
Runs
Locally
Version
0.3.0
Listing updated
today

Similar MCP servers

About CommerceWeave MCP

CommerceWeave MCP is an open-source MCP server for e-commerce. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a 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

Add to claude_desktop_config.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>"
      }
    }
  }
}

Add to ~/.cursor/mcp.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>"
      }
    }
  }
}

Add to .vscode/mcp.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>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.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>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "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>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • COMMERCEWEAVE_MODEread_only (default) | proposal | approval_required
  • COMMERCEWEAVE_DEMOtrue = synthetic demo data, no credentials needed
  • ALLEGRO_ENABLEDtrue to enable the Allegro connection
  • ALLEGRO_ENVIRONMENTsandbox | production
  • ALLEGRO_CLIENT_IDAllegro application client id
  • ALLEGRO_CLIENT_SECRETAllegro application client secret
  • BASE_ENABLEDtrue to enable the Base.com connection
  • BASE_API_TOKENBase.com API token (sent as X-BLToken)
  • WOO_ENABLEDtrue to enable the WooCommerce connection
  • WOO_STORE_URLhttps URL of the WooCommerce store
  • WOO_CONSUMER_KEYWooCommerce REST API consumer key
  • WOO_CONSUMER_SECRETWooCommerce REST API consumer secret

Tools this server provides (2)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Open source

MIT licensed

CommerceWeave MCP 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.

How AIPoweredBot checks servers