Wb Mcp Server

wb-mcp-server

[](https://www.npmjs.com/package/wb-mcp-server) [](LICENSE) [](https://t.me/dmkosik)

[Русская версия](README.ru.md)

Author: Дмитрий Косик · 📢 Telegram channel @dmkosik · 💬 Contact author @feeyh

MCP server for the Wildberries Seller API. Connect any AI agent (Claude Desktop, OpenClaw, or any MCP client) to your Wildberries store.

Quick Start

1. Install

npm install -g wb-mcp-server

2. Get a WB API token

Create an API token in your WB Seller Dashboard under Settings > API Access.

3. Add to Claude Desktop config

{
  "mcpServers": {
    "wildberries": {
      "command": "wb-mcp-server",
      "env": {
        "WB_API_TOKEN": "your_token_here"
      }
    }
  }
}

> Windows: spawn wb-mcp-server ENOENT error > > If Claude Desktop can't find the wb-mcp-server command, use npx instead: > > ``json > { > "mcpServers": { > "wildberries": { > "command": "npx", > "args": ["-y", "wb-mcp-server"], > "env": { > "WB_API_TOKEN": "your_token_here" > } > } > } > } > `` > > This commonly happens with the Microsoft Store version of Claude Desktop, which doesn't see the global npm packages path.

Updating to the latest version

New versions are released regularly — for example, v0.4.0 added 10 new tools (acquiring report, sales summary, content cards, supplies, documents, seller info, item rating). The server does not auto-update — you need to update it manually.

Step 1. Update the package

If installed globally (Claude Desktop config uses "command": "wb-mcp-server"):

npm install -g wb-mcp-server@latest

If using npx (Claude Desktop config uses "command": "npx"):

npx -y wb-mcp-server@latest

If npx keeps pulling an old cached version, clear the cache:

npm cache clean --force

Step 2. Fully restart Claude Desktop

Quit the app from the system tray (not just closing the window), then reopen it. Otherwise Claude will keep using the old server process.

Step 3. Verify the version

npm list -g wb-mcp-server

Or ask Claude: "Which wb-mcp-server tools are available to you?" — v0.4.3 should show 35 tools.

Available Tools (35)

Reviews & Questions

| Tool | Description | Type | |---|---|---| | get_feedbacks | Get customer reviews | read | | reply_feedback | Reply to a review | write | | get_questions | Get customer questions | read | | reply_question | Reply to a question | write | | get_unanswered_count | Count of unanswered reviews | read |

Statistics & Analytics

| Tool | Description | Type | |---|---|---| | get_stocks | Warehouse stock levels | read | | get_orders | Recent orders | read | | get_sales | Sales data | read | | get_financial_report | Detailed report: commissions, logistics, storage, penalties | read | | get_nm_report | Per-product report (views, cart, orders, buyouts) | read | | get_warehouses_inventory | Real-time warehouse inventory report (async) | read | | get_item_rating | Seller rating + feedback increase by star | read |

Advertising

| Tool | Description | Type | |---|---|---| | get_advert_list | Advertising campaigns list | read | | get_advert_stats | Campaign statistics | read | | get_advert_balance | Advertising account balance | read | | update_advert_bid | Update campaign bids | write |

Pricing

| Tool | Description | Type | |---|---|---| | get_prices | Product list with prices and discounts | read | | update_prices | Update prices and discounts | write |

Finance

| Tool | Description | Type | |---|---|---| | get_seller_balance | Current seller account balance | read | | get_sales_reports_summary | Weekly sales report summaries (for dashboards) | read | | get_acquiring_report_list | Acquiring expense report summaries | read | | get_acquiring_report | Detailed acquiring (card-processing) fees | read |

Product Cards

| Tool | Description | Type | |---|---|---| | get_content_cards | Product cards listing with cursor pagination | read |

FBS Supplies

| Tool | Description | Type | |---|---|---| | get_supplies | FBS supplies list | read | | create_supply | Create a new open FBS supply | write |

FBW Supplies (to WB warehouses)

| Tool | Description | Type | |---|---|---| | get_fbw_supplies | FBW supplies list with numeric IDs (e.g. 38419461) | read | | get_fbw_supply | FBW supply details: warehouse, dates, declared/accepted qty | read | | get_fbw_supply_goods | Supply composition by barcode — for acceptance reconciliation | read | | get_fbw_supply_package | Supply boxes layout | read | | get_wb_warehouses | WB warehouses reference | read | | get_paid_acceptance_report | Paid acceptance report (async) | read | | get_acceptance_coefficients | WB warehouse acceptance coefficients for 14 days | read |

Documents

| Tool | Description | Type | |---|---|---| | get_documents | Financial documents: invoices, reports, acts | read |

Seller Info

| Tool | Description | Type | |---|---|---| | get_seller_info | Name, INN, trademark | read | | get_jam_subscription | Jam subscription status (requires Service token) | read |

Example prompts

Ask your AI agent (after connecting the MCP server):

• "How many unanswered reviews do I have?"
• "Show me the seller rating and feedback breakdown by star for the last 2 weeks"
• "Give me a weekly P&L summary: payouts, logistics, storage, penalties"
• "List the latest financial documents (invoices, weekly reports)"
• "Show acquiring fees for the past month"
• "What's my current account balance and how much can I withdraw?"
• "Find product card by nmID 391083595"
• "List my open FBS supplies"
• "How many sales did I have last week?"
• "Which products convert best from views to orders?"

Configuration

| Variable | Description | Required | |---|---|---| | WB_API_TOKEN | Wildberries Seller API token | Yes |

Or pass via CLI: wb-mcp-server --token=your_token

Development

git clone https://github.com/dmitriykosik74-rgb/wb-mcp-server.git
cd wb-mcp-server
npm install
npm test
npm run build

Contributing

1. Fork the repo
2. Create a feature branch (git checkout -b feature/my-feature)
3. Commit your changes (git commit -m 'feat: add my feature')
4. Push and create a Pull Request

License

[MIT](LICENSE)

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: dmitriykosik74-rgb
• Source: dmitriykosik74-rgb/wb-mcp-server
• License: MIT

Install and usage instructions live in the source repository linked above.