wildberries-api-mcp

MCP server for the Wildberries Seller API. Gives AI assistants access to 296 tools across 13 API sections — product management, orders, analytics, finances, promotions, and more.

Supports Claude Desktop (stdio) and any MCP client that speaks Streamable HTTP or SSE (claude.ai, ChatGPT, etc.).

Quick Start — Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "wildberries": {
      "command": "npx",
      "args": ["-y", "wildberries-api-mcp"],
      "env": {
        "WB_API_TOKEN": "your-wildberries-api-token"
      }
    }
  }
}

Get your API token at seller.wildberries.ru → Settings → API Access.

Remote / SSE Mode

For shared team access or web-based MCP clients, run the server with Docker:

docker run -p 3000:3000 \
  -e MCP_TRANSPORT=sse \
  -e BASE_URL=https://your-domain.com \
  -e OAUTH_ENCRYPTION_KEY=$(openssl rand -hex 32) \
  wildberries-api-mcp

Then connect your MCP client to https://your-domain.com. On first connection you'll be redirected to an authorization page where you enter your WB API token. The token is encrypted and embedded in the OAuth access token — it is never stored on the server.

Readonly Mode

Restricts the session to safe read-only operations (analytics, reports, tariffs, finances). Write operations (orders, product edits, price changes) are blocked.

stdio:

"env": {
  "WB_API_TOKEN": "your-token",
  "WB_READONLY": "true"
}

SSE: check the Read only checkbox on the authorization page.

Available Tools

The server exposes 296 tools organized into 13 sections. Because listing all tools at once would overwhelm the context, three meta-tools help AI assistants navigate:

1. list_sections — returns all section keys and descriptions
2. list_section_tools — returns tool names and schemas for a given section
3. call_tool — calls any tool by name with the given arguments

Sections

| Key | Section | Description | Tools | |-----|---------|-------------|-------| | general | General | API connection check, seller info, user management, news | 9 | | products | Product Management | Create/update/delete cards, prices & discounts, media, tags, warehouses | 75 | | orders_fbs | FBS Orders | Assembly orders, supplies, stickers, passes, cross-border | 39 | | orders_fbw | FBW Supplies | WB warehouse supplies, packaging, transit | 6 | | orders_dbs | DBS Orders | Seller delivery — assembly, confirmation, stickers | 32 | | orders_dbw | DBW Orders | WB delivery — assembly, confirmation, stickers | 13 | | in_store_pickup | In-Store Pickup | Click-and-collect — assembly, readiness, confirmation | 20 | | communications | Customer Communication | Questions, reviews, buyer chat, return applications | 24 | | promotion | Marketing & Promotions | Ad campaigns, bids, media campaigns, promo calendar | 37 | | analytics | Analytics | Sales funnel, search queries, stock reports, CSV exports | 25 | | reports | Reports | Storage, labeling, retention, paid storage, sales by region | 24 | | tariffs | Tariffs | Commission rates, storage/box/pallet/supply/return tariffs | 6 | | finances | Finances | Seller balance, sales reports, acquiring, documents | 18 |

Tested Methods

The following tools have been verified against the live Wildberries API:

| Tool | Section | Description | |------|---------|-------------| | products_product_cards_list | Product Management | Fetch paginated list of product cards with photos | | analytics_product_cards_statistics_per_period | Analytics | Compare key metrics (orders, clicks, add-to-cart) across two periods | | analytics_main_page | Analytics | Main analytics dashboard — revenue, orders, returns, conversion |

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | WB_API_TOKEN | Yes (stdio) | Wildberries API token | | MCP_TRANSPORT | No | Set to sse to enable HTTP/SSE mode | | PORT | No | HTTP port in SSE mode (default: 3000) | | BASE_URL | No | Public URL in SSE mode (default: http://localhost:3000) | | OAUTH_ENCRYPTION_KEY | No | 64-char hex key for AES-256-GCM token encryption in SSE mode | | WB_READONLY | No | Set to true to enable readonly mode in stdio |

License

MIT