Wildberries Seller API MCP server

wildberries-mcp-ru

An MCP server covering all seventeen Wildberries Seller API hosts: sales, stock, product cards, prices, financial reports and reviews

MCP server

High risk

We rate an entry high when the tool writes to external systems, handles money, production databases or secrets, or runs arbitrary commands. The CLI installs it only with your consent.

Why this level

  • 108 of 307 methods write data: prices, discounts, supplies, product cards
  • It can send buyer chat messages on the seller's behalf
  • 12 methods are irreversible, start with a read-only token if the API supports it
All reasons and checks
Russian stack

ilyautov/wildberries-mcp-ru

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add mcp/wildberries-mcp-ru

Detects the agents on your machine, checks the risk and pins the version.

Other ways to install

This entry is high risk, so there is no one-click install. Review the code and add the config by hand.

Run in a terminal

claude mcp add --transport stdio --env 'WB_API_TOKEN=<your WB_API_TOKEN>' wildberries-mcp-ru -- uvx wildberries-mcp-ru==0.6.0

Or add to the file .mcp.json, in the project

{
  "mcpServers": {
    "wildberries-mcp-ru": {
      "command": "uvx",
      "args": [
        "wildberries-mcp-ru==0.6.0"
      ],
      "env": {
        "WB_API_TOKEN": "<your WB_API_TOKEN>"
      }
    }
  }
}

If the file already exists, add the server inside the mcpServers key.

Keys and settings

WB_API_TOKENsecret, required
Токен из кабинета seller.wildberries.ru, Настройки → Доступ к API. Уходит в Authorization без Bearer.

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Add to the file ~/.cursor/mcp.json, for all projects

{
  "mcpServers": {
    "wildberries-mcp-ru": {
      "command": "uvx",
      "args": [
        "wildberries-mcp-ru==0.6.0"
      ],
      "env": {
        "WB_API_TOKEN": "<your WB_API_TOKEN>"
      }
    }
  }
}

If the file already exists, add the server inside the mcpServers key. For a single project, put the same block into .cursor/mcp.json.

Keys and settings

WB_API_TOKENsecret, required
Токен из кабинета seller.wildberries.ru, Настройки → Доступ к API. Уходит в Authorization без Bearer.

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Run in a terminal

code --add-mcp '{"name":"wildberries-mcp-ru","type":"stdio","command":"uvx","args":["wildberries-mcp-ru==0.6.0"],"env":{"WB_API_TOKEN":"<your WB_API_TOKEN>"}}'

Or add to the file .vscode/mcp.json, in the project

{
  "servers": {
    "wildberries-mcp-ru": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "wildberries-mcp-ru==0.6.0"
      ],
      "env": {
        "WB_API_TOKEN": "<your WB_API_TOKEN>"
      }
    }
  }
}

If the file already exists, add the server inside the servers key.

Keys and settings

WB_API_TOKENsecret, required
Токен из кабинета seller.wildberries.ru, Настройки → Доступ к API. Уходит в Authorization без Bearer.

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Run in a terminal

codex mcp add wildberries-mcp-ru --env 'WB_API_TOKEN=<your WB_API_TOKEN>' -- uvx wildberries-mcp-ru==0.6.0

Or add to the file ~/.codex/config.toml, for all projects

[mcp_servers.wildberries-mcp-ru]
command = "uvx"
args = ["wildberries-mcp-ru==0.6.0"]
env = { WB_API_TOKEN = "<your WB_API_TOKEN>" }

If the file already exists, append the block to the end.

Keys and settings

WB_API_TOKENsecret, required
Токен из кабинета seller.wildberries.ru, Настройки → Доступ к API. Уходит в Authorization без Bearer.

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Run in a terminal

gemini mcp add -s user -e 'WB_API_TOKEN=<your WB_API_TOKEN>' wildberries-mcp-ru uvx wildberries-mcp-ru==0.6.0

Or add to the file ~/.gemini/settings.json, for all projects

{
  "mcpServers": {
    "wildberries-mcp-ru": {
      "command": "uvx",
      "args": [
        "wildberries-mcp-ru==0.6.0"
      ],
      "env": {
        "WB_API_TOKEN": "<your WB_API_TOKEN>"
      }
    }
  }
}

If the file already exists, add the server inside the mcpServers key.

Keys and settings

WB_API_TOKENsecret, required
Токен из кабинета seller.wildberries.ru, Настройки → Доступ к API. Уходит в Authorization без Bearer.

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Add to the file ~/.config/devin/mcp_config.json, for all projects

{
  "mcpServers": {
    "wildberries-mcp-ru": {
      "command": "uvx",
      "args": [
        "wildberries-mcp-ru==0.6.0"
      ],
      "env": {
        "WB_API_TOKEN": "<your WB_API_TOKEN>"
      }
    }
  }
}

If the file already exists, add the server inside the mcpServers key. Legacy Cascade keeps the MCP config in ~/.codeium/windsurf/mcp_config.json.

Keys and settings

WB_API_TOKENsecret, required
Токен из кабинета seller.wildberries.ru, Настройки → Доступ к API. Уходит в Authorization без Bearer.

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Formerly Windsurf.

Add to the file cline_mcp_settings.json, for all projects

{
  "mcpServers": {
    "wildberries-mcp-ru": {
      "command": "uvx",
      "args": [
        "wildberries-mcp-ru==0.6.0"
      ],
      "env": {
        "WB_API_TOKEN": "<your WB_API_TOKEN>"
      }
    }
  }
}

If the file already exists, add the server inside the mcpServers key. Open the settings file in Cline: MCP Servers tab, Configure MCP Servers.

Keys and settings

WB_API_TOKENsecret, required
Токен из кабинета seller.wildberries.ru, Настройки → Доступ к API. Уходит в Authorization без Bearer.

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Add to the file .roo/mcp.json, in the project

{
  "mcpServers": {
    "wildberries-mcp-ru": {
      "command": "uvx",
      "args": [
        "wildberries-mcp-ru==0.6.0"
      ],
      "env": {
        "WB_API_TOKEN": "<your WB_API_TOKEN>"
      }
    }
  }
}

If the file already exists, add the server inside the mcpServers key.

Keys and settings

WB_API_TOKENsecret, required
Токен из кабинета seller.wildberries.ru, Настройки → Доступ к API. Уходит в Authorization без Bearer.

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

A fork of Roo Code, same .roo folders.

Add to the file opencode.json, in the project

{
  "mcp": {
    "wildberries-mcp-ru": {
      "type": "local",
      "command": [
        "uvx",
        "wildberries-mcp-ru==0.6.0"
      ],
      "environment": {
        "WB_API_TOKEN": "<your WB_API_TOKEN>"
      }
    }
  }
}

If the file already exists, add the server inside the mcp key.

Keys and settings

WB_API_TOKENsecret, required
Токен из кабинета seller.wildberries.ru, Настройки → Доступ к API. Уходит в Authorization без Bearer.

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Add to the file ~/.config/zed/settings.json, for all projects

{
  "context_servers": {
    "wildberries-mcp-ru": {
      "command": "uvx",
      "args": [
        "wildberries-mcp-ru==0.6.0"
      ],
      "env": {
        "WB_API_TOKEN": "<your WB_API_TOKEN>"
      }
    }
  }
}

If the file already exists, add the server inside the context_servers key.

Keys and settings

WB_API_TOKENsecret, required
Токен из кабинета seller.wildberries.ru, Настройки → Доступ к API. Уходит в Authorization без Bearer.

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Add to the file .codeassistant/mcp.json, in the project

{
  "mcpServers": {
    "wildberries-mcp-ru": {
      "command": "uvx",
      "args": [
        "wildberries-mcp-ru==0.6.0"
      ],
      "env": {
        "WB_API_TOKEN": "<your WB_API_TOKEN>"
      }
    }
  }
}

If the file already exists, add the server inside the mcpServers key.

Keys and settings

WB_API_TOKENsecret, required
Токен из кабинета seller.wildberries.ru, Настройки → Доступ к API. Уходит в Authorization без Bearer.

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

You will need: uv

Checked against the repository on Sep 25, 2026, commit 7198790.

Text for your agent

Install the server with uvx wildberries-mcp-ru, add it to your client config with a WB_API_TOKEN from the seller.wildberries.ru dashboard, API access section.

Other ways from the author
uvx wildberries-mcp-ru

Installs the release from PyPI.

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

What it does

The server installs from PyPI and gives an agent 307 Wildberries Seller API methods across seventeen hosts: assembly tasks and supplies, seller analytics, product cards, advertising, digital goods, reviews, prices and discounts, finance, buyer chat, documents and returns. Of these, 187 are read methods, 108 are write, and 12 are irreversible. The server stores tokens and cabinet data locally in a file with 600 permissions, supports multiple cabinets, and lets you switch between them from the chat. The core and method catalog come as a dependency from the same author's marketplaces-mcp-ru package; this package installs Wildberries only.

Who it is for. For sellers and managers running a Wildberries store who want full seller API access from a chat with an agent.

Good fit when

  • You need full Wildberries Seller API coverage, not a handful of functions
  • You manage several seller cabinets and need to switch between them
  • You need both analytics reading and operations on prices, supplies, cards and reviews

Not a fit when

  • You need several marketplaces at once: install marketplaces-mcp-ru instead
  • You need read-only access with no risk of changing prices, supplies or replying to a buyer

Example request

Show my Wildberries sales for the week and which products risk going out of stock

Limitations

You need a Wildberries seller token with the right access scopes from the seller dashboard. Wildberries methods have varying and sometimes very strict rate limits, some capped at one call per minute. The token is sent in the Authorization header without a Bearer prefix, which can cause a misleading 401 if the client is misconfigured. 12 methods are irreversible.

How to disable. Remove the wb entry from your MCP client config and delete ~/.marketplace-mcp/cabinets.json if the cabinets are no longer needed.

MCP

Transport
stdio
Authentication
API key
Environment variables
Environment variables
WB_API_TOKEN
required, secret
Seller token from seller.wildberries.ru, Settings, API access

Security check

  • 108 of 307 methods write data: prices, discounts, supplies, product cards
  • It can send buyer chat messages on the seller's behalf
  • 12 methods are irreversible, start with a read-only token if the API supports it

README in short

The README gives a table of Wildberries Seller API hosts with the method count for each, explains install via uvx or npx skills add, the token storage format, and common auth and rate-limit errors. A section compares the package with marketplaces-mcp-ru and lists the author's related projects: business-mcp-ru, moysklad-mcp-ru, humanizer-ru.

FAQ

How does this differ from marketplaces-mcp-ru?

Only in scope: this one installs Wildberries alone, while marketplaces-mcp-ru installs four marketplaces on the same core.

Why does auth fail with a correct token?

Usually because the server sends the token without a Bearer prefix, or an active cabinet in cabinets.json overrides environment variables.

Official

Salesforce's official DX MCP server: work with orgs, metadata, data, users and Apex tests from your agent

MCP serverHigh risk483Repository stars
Official

Yandex's official skill set: catalog, prices, stock, orders, storefront and a weekly checkup for a Yandex Kit store, through Claude Code or Codex

PluginHigh riskRussian stackNo VPN needed28Repository stars
Editors’ pick

Full 65-operation YouGile API coverage with configurable permissions, write confirmation and a shared company rate limit

MCP serverHigh riskRussian stackNo VPN needed

Bitrix24 portal MCP server

MCP-сервер портала Битрикс24

Official

Bitrix24's official per-portal MCP: an external agent uses OAuth or a token to read and change tasks, deals, meetings and mail

MCP serverHigh riskRussian stackNo VPN needed
Foxx AIWildberries Seller API MCP server

I am Foxx AI and I have already vetted this tool. Ask about install, setup or anything else, and I will keep it simple.