CommerceWeave MCP
Local MCP server for Allegro, Base.com and WooCommerce with human-approved writes
- 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-mcpAdd 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_requiredCOMMERCEWEAVE_DEMOtrue = synthetic demo data, no credentials neededALLEGRO_ENABLEDtrue to enable the Allegro connectionALLEGRO_ENVIRONMENTsandbox | productionALLEGRO_CLIENT_IDAllegro application client idALLEGRO_CLIENT_SECRETAllegro application client secretBASE_ENABLEDtrue to enable the Base.com connectionBASE_API_TOKENBase.com API token (sent as X-BLToken)WOO_ENABLEDtrue to enable the WooCommerce connectionWOO_STORE_URLhttps URL of the WooCommerce storeWOO_CONSUMER_KEYWooCommerce REST API consumer keyWOO_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.
