WB MCP Server

Install

{
  "mcpServers": {
    "wildberries": {
      "command": "uvx",
      "args": ["wb-mcp-server"],
      "env": {
        "WB_API_TOKEN": "your Wildberries API token",
        "DATA_DIR": "~/.wb-mcp"
      }
    }
  }
}

This is third-party code. Review the repository files before installing.

What it does

The server covers most of the Wildberries Seller API: product cards and cards with errors, prices and discounts, promotions, ad campaigns with bids and negative phrases, analytics and sales funnel, FBS and DBS assembly tasks, FBW supplies with intake coefficients, warehouses and stock, sales reports, reviews, questions and buyer chats. Every call takes a shop_id, so several seller accounts live in one conversation. Docker mode adds a web dashboard with call stats, store management and diagnostics of tokens and the WB API that notices when a previously working method starts failing consistently. Store tokens are stored encrypted.

Who it is for. For Wildberries sellers and managers who run one or several accounts and want to manage them in plain language.

Example request

Which of my cards are blocked and why? And which warehouses have an intake coefficient of 0 or 1 right now?

Limitations

Requires a Wildberries Seller API token, valid for 180 days, with write scopes granted separately. WB rate limits are strict: some methods allow a few requests per minute, a 4XX response counts as ten requests, and all stores on one server share one IP's limit. The web UI is not token-protected and must not face the internet, and the server does not terminate HTTPS. The encryption key sits next to the data. The author develops the server for his own needs.

How to disable. Run claude mcp remove wildberries or delete the block from the client config, and stop Docker with docker compose down. Revoke the WB token in the seller portal.

MCP

Transport

stdio

Authentication

API key

Security check

• Changes prices, bids and ad budget in live seller accounts
• Stores tokens for several stores
• The unauthenticated dashboard is dangerous on an open network

README in short

The README in English, Russian and Chinese lists Seller API areas with tool counts, with the full list in docs/tools.md. It shows two paths: uvx or pip with stdio, and Docker with the dashboard and SSE. Eleven clients have separate Russian-language guides. A large section covers multi-store use, WB limits, token storage and what the server does not protect. MIT license.

Related