WB MCP Server

Install

Works in

• Claude Code
• Claude Desktop
• Cursor
• Windsurf
• VS Code
• GitHub Copilot
• Cline
• Gemini CLI
• Codex
• SourceCraft
• Koda
• Coddy

Services

• Wildberries

Manual install

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

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?

MCP

Transport

stdio

Authentication

not required

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.

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.