Wildberries

MCP server for Wildberries Seller API — products, orders, supplies, analytics, advertising

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Not yet automatically verified

We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "wildberries": {
      "command": "uvx",
      "args": [
        "mcp-server-wildberries"
      ]
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Documentation Overview

mcp-server-wildberries

mcp-name: io.github.dontsovcmc/wildberries

MCP-сервер для Wildberries Seller API — товары, заказы, поставки, аналитика, реклама, финансы.

235 действий, покрывающих все разделы WB API.

Построен по официальной документации Wildberries API.

Архитектура

Сервер использует паттерн search + execute — вместо 235 отдельных инструментов предоставляет 3:

Инструмент	Описание
`wb_search`	Поиск действий по описанию на естественном языке
`wb_execute`	Выполнение действия по ID
`wb_execute_file`	Выполнение действия со скачиванием файла

Это экономит токены в контексте LLM — схемы 3 инструментов вместо 235.

Как это работает

Code

LLM: wb_search("cancel fbs order")
→ [{"id": "fbs-order-cancel", "params_schema": {"order_id": "int"}, ...}]

LLM: wb_execute("fbs-order-cancel", '{"order_id": 12345}')
→ {"status": "ok"}

Настройка

1. Получите API-токен Wildberries

Откройте Личный кабинет продавца WB → Настройки → Доступ к API → Создать токен.

2. Установите и подключите

macOS / Linux

Установка:

Terminal

pip install mcp-server-wildberries

Подключение к Claude Code (токен в командной строке):

Terminal

claude mcp add wildberries -e WB_TOKEN=ваш-токен -- mcp-server-wildberries

Подключение к Claude Code (токен из .env файла):

bash

source .env && claude mcp add wildberries -e WB_TOKEN -- mcp-server-wildberries

Удаление MCP-сервера:

Terminal

claude mcp remove wildberries

CLI без Claude (токен в командной строке):

bash

WB_TOKEN=ваш-токен mcp-server-wildberries ping

CLI без Claude (токен из .env файла):

bash

source .env && mcp-server-wildberries ping

Windows

Установка:

Terminal

pip install mcp-server-wildberries

Подключение к Claude Code (токен в командной строке):

cmd

set WB_TOKEN=ваш-токен && claude mcp add wildberries -e WB_TOKEN -- mcp-server-wildberries

Подключение к Claude Code (токен из .env файла):

cmd

for /f "tokens=1,2 delims==" %a in (.env) do set %a=%b
claude mcp add wildberries -e WB_TOKEN -- mcp-server-wildberries

Удаление MCP-сервера:

Terminal

claude mcp remove wildberries

CLI без Claude (токен в командной строке):

cmd

set WB_TOKEN=ваш-токен && mcp-server-wildberries ping

CLI без Claude (токен из .env файла):

cmd

for /f "tokens=1,2 delims==" %a in (.env) do set %a=%b
mcp-server-wildberries ping

Запуск через uvx (без установки)

Если не хотите устанавливать пакет глобально, используйте uvx — он скачает и запустит автоматически:

bash

# Подключение к Claude Code
claude mcp add wildberries -e WB_TOKEN=ваш-токен -- uvx mcp-server-wildberries

# CLI
WB_TOKEN=ваш-токен uvx mcp-server-wildberries ping

Запуск через --mcp-config (на одну сессию)

Подключает сервер только на время одной сессии Claude, не сохраняя в настройки. Токен хранится в отдельном .env.mcp файле, а не в конфиге Claude.

Из JSON-строки:

Terminal

claude --mcp-config '{"wildberries":{"command":"bash","args":["-c","source ~/.env.mcp && exec uvx mcp-server-wildberries"]}}'

Из файла:

Terminal

claude --mcp-config ~/mcp-servers.json

Только указанные серверы, без сохранённых:

Terminal

claude --strict-mcp-config --mcp-config ~/mcp-servers.json

Пример ~/mcp-servers.json:

config.json

{
  "wildberries": {
    "command": "bash",
    "args": ["-c", "source ~/.env.mcp && exec uvx mcp-server-wildberries"]
  }
}

Пример ~/.env.mcp:

Code

WB_TOKEN=ваш-токен

Плюсы:

Токены в отдельном файле .env.mcp, а не в настройках Claude
Один файл mcp-servers.json на все проекты — легко делиться конфигом в команде
--strict-mcp-config — запуск с точным набором серверов, без лишних
Не засоряет глобальные настройки при экспериментах

Минусы:

Сервер не сохраняется между сессиями — нужно указывать флаг при каждом запуске
Длинная команда запуска, если без файла

После подключения перезапустите Claude Code.

Переменные окружения

Переменная	Обязательная	По умолчанию	Описание
`WB_TOKEN`	Да	—	API-токен Wildberries (JWT)
`WB_TIMEOUT`	Нет	30	Таймаут HTTP-запросов к API (секунды)
`WB_FILE_TIMEOUT`	Нет	60	Таймаут скачивания файлов (секунды)

Доступные действия (235)

Все действия доступны через wb_search → wb_execute. Подробное описание каждого действия — в документации по разделам:

Домен	Кол-во	Описание
`general`	9	Ping, информация о продавце, пользователи
`content`	18	Категории, карточки товаров, теги, бренды
`fbs_orders`	31	FBS-заказы, стикеры, поставки, пропуска, метаданные
`dbw_orders`	16	DBW-заказы (доставка WB)
`dbs_orders`	20	DBS-заказы (дропшиппинг)
`pickup_orders`	16	Самовывоз (click & collect)
`fbw_supplies`	7	FBW-поставки на склад WB
`advertising`	26	Рекламные кампании, ставки, статистика
`communications`	22	Вопросы, отзывы, чаты
`tariffs`	5	Комиссии, тарифы на доставку
`analytics`	17	Воронка продаж, поисковые запросы, остатки
`reports`	24	Заказы, продажи, остатки, маркировка
`finance`	12	Баланс, отчёты, эквайринг, документы
`wbd`	12	Цифровые товары, ключи активации

Примеры поиска

Code

wb_search("новые заказы fbs")
wb_search("баланс")
wb_search("отзывы", domain="communications")
wb_search("download report", domain="reports")

CLI

bash

# MCP-сервер (по умолчанию, без аргументов)
mcp-server-wildberries

# Все доступные команды
mcp-server-wildberries --help

# Справка по конкретной команде
mcp-server-wildberries fbs-orders --help

# Примеры команд
mcp-server-wildberries ping
mcp-server-wildberries seller-info
mcp-server-wildberries fbs-orders-new
mcp-server-wildberries tariff-commissions
mcp-server-wildberries fbs-orders --date-from 2025-01-01 --limit 10
mcp-server-wildberries advert-campaign-rename 12345 "Новое название"
mcp-server-wildberries analytics-csv-download dl_abc report.csv

# Версия
mcp-server-wildberries --version

Пример

bash

$ WB_TOKEN=ваш-токен mcp-server-wildberries ping
{"TS": "2026-05-06T18:06:30Z", "Status": "OK"}

$ WB_TOKEN=ваш-токен mcp-server-wildberries seller-info
{"name": "ИП Иванов И.И.", "sid": "...", "tradeMark": "MyBrand"}

Pydantic-модели

Модели параметров доступны как отдельная библиотека для использования в своих Python-программах:

Terminal

pip install mcp-server-wildberries

server.ts

from mcp_server_wildberries.models import FbsOrdersParams, SubjectsListParams

params = FbsOrdersParams(date_from="2025-01-01", limit=50)
# params.model_dump() → {"date_from": "2025-01-01", "date_to": "", "limit": 50, ...}

62 Pydantic-модели покрывают параметры всех 235 действий. Полный список — в src/mcp_server_wildberries/models.py.

Разработка

Terminal

pip install -e ".[test]"
ruff check src/ tests/
pytest tests/ -v

Лицензия

MIT

Read the full README →View source on GitHub →

Related MCP Servers

View all in Developer Tools View all alternatives

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Wildberries

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "wildberries": { "command": "npx", "args": ["-y", "wildberries"] } }

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/wildberries?style=directory)](https://allmcps.com/mcp/wildberries)

HTML Embed

<a href="https://allmcps.com/mcp/wildberries"><img src="https://allmcps.com/api/badge/wildberries?style=directory" alt="Wildberries on AllMCPs" /></a>

Technical Specs & Signals

CategoryDeveloper Tools

37Quality signal: Fair · 37/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools16/30

Adoption & activity2/15

Community engagement0/10

A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.

★ Featured

Moxie Docs MCP

MCP & Agent Skills for Automated Documentation, and codebase conventions + context

Explore Server →

Own this project?

This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge — proof is checked automatically, then reviewed by our team.

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💻 Developer Tools →Best MCP servers for Developers →Alternatives to Wildberries →Install in Claude Desktop Install in Cursor Install in VS Code

Wildberries

MCP server for Wildberries Seller API — products, orders, supplies, analytics, advertising

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Not yet automatically verified

We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "wildberries": {
      "command": "uvx",
      "args": [
        "mcp-server-wildberries"
      ]
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Documentation Overview

mcp-server-wildberries

mcp-name: io.github.dontsovcmc/wildberries

MCP-сервер для Wildberries Seller API — товары, заказы, поставки, аналитика, реклама, финансы.

235 действий, покрывающих все разделы WB API.

Построен по официальной документации Wildberries API.

Архитектура

Сервер использует паттерн search + execute — вместо 235 отдельных инструментов предоставляет 3:

Инструмент	Описание
`wb_search`	Поиск действий по описанию на естественном языке
`wb_execute`	Выполнение действия по ID
`wb_execute_file`	Выполнение действия со скачиванием файла

Это экономит токены в контексте LLM — схемы 3 инструментов вместо 235.

Как это работает

Code

LLM: wb_search("cancel fbs order")
→ [{"id": "fbs-order-cancel", "params_schema": {"order_id": "int"}, ...}]

LLM: wb_execute("fbs-order-cancel", '{"order_id": 12345}')
→ {"status": "ok"}

Настройка

1. Получите API-токен Wildberries

Откройте Личный кабинет продавца WB → Настройки → Доступ к API → Создать токен.

2. Установите и подключите

macOS / Linux

Установка:

Terminal

pip install mcp-server-wildberries

Подключение к Claude Code (токен в командной строке):

Terminal

claude mcp add wildberries -e WB_TOKEN=ваш-токен -- mcp-server-wildberries

Подключение к Claude Code (токен из .env файла):

bash

source .env && claude mcp add wildberries -e WB_TOKEN -- mcp-server-wildberries

Удаление MCP-сервера:

Terminal

claude mcp remove wildberries

CLI без Claude (токен в командной строке):

bash

WB_TOKEN=ваш-токен mcp-server-wildberries ping

CLI без Claude (токен из .env файла):

bash

source .env && mcp-server-wildberries ping

Windows

Установка:

Terminal

pip install mcp-server-wildberries

Подключение к Claude Code (токен в командной строке):

cmd

set WB_TOKEN=ваш-токен && claude mcp add wildberries -e WB_TOKEN -- mcp-server-wildberries

Подключение к Claude Code (токен из .env файла):

cmd

for /f "tokens=1,2 delims==" %a in (.env) do set %a=%b
claude mcp add wildberries -e WB_TOKEN -- mcp-server-wildberries

Удаление MCP-сервера:

Terminal

claude mcp remove wildberries

CLI без Claude (токен в командной строке):

cmd

set WB_TOKEN=ваш-токен && mcp-server-wildberries ping

CLI без Claude (токен из .env файла):

cmd

for /f "tokens=1,2 delims==" %a in (.env) do set %a=%b
mcp-server-wildberries ping

Запуск через uvx (без установки)

Если не хотите устанавливать пакет глобально, используйте uvx — он скачает и запустит автоматически:

bash

# Подключение к Claude Code
claude mcp add wildberries -e WB_TOKEN=ваш-токен -- uvx mcp-server-wildberries

# CLI
WB_TOKEN=ваш-токен uvx mcp-server-wildberries ping

Запуск через --mcp-config (на одну сессию)

Из JSON-строки:

Terminal

claude --mcp-config '{"wildberries":{"command":"bash","args":["-c","source ~/.env.mcp && exec uvx mcp-server-wildberries"]}}'

Из файла:

Terminal

claude --mcp-config ~/mcp-servers.json

Только указанные серверы, без сохранённых:

Terminal

claude --strict-mcp-config --mcp-config ~/mcp-servers.json

Пример ~/mcp-servers.json:

config.json

{
  "wildberries": {
    "command": "bash",
    "args": ["-c", "source ~/.env.mcp && exec uvx mcp-server-wildberries"]
  }
}

Пример ~/.env.mcp:

Code

WB_TOKEN=ваш-токен

Плюсы:

Токены в отдельном файле .env.mcp, а не в настройках Claude
Один файл mcp-servers.json на все проекты — легко делиться конфигом в команде
--strict-mcp-config — запуск с точным набором серверов, без лишних
Не засоряет глобальные настройки при экспериментах

Минусы:

Сервер не сохраняется между сессиями — нужно указывать флаг при каждом запуске
Длинная команда запуска, если без файла

После подключения перезапустите Claude Code.

Переменные окружения

Переменная	Обязательная	По умолчанию	Описание
`WB_TOKEN`	Да	—	API-токен Wildberries (JWT)
`WB_TIMEOUT`	Нет	30	Таймаут HTTP-запросов к API (секунды)
`WB_FILE_TIMEOUT`	Нет	60	Таймаут скачивания файлов (секунды)

Доступные действия (235)

Домен	Кол-во	Описание
`general`	9	Ping, информация о продавце, пользователи
`content`	18	Категории, карточки товаров, теги, бренды
`fbs_orders`	31	FBS-заказы, стикеры, поставки, пропуска, метаданные
`dbw_orders`	16	DBW-заказы (доставка WB)
`dbs_orders`	20	DBS-заказы (дропшиппинг)
`pickup_orders`	16	Самовывоз (click & collect)
`fbw_supplies`	7	FBW-поставки на склад WB
`advertising`	26	Рекламные кампании, ставки, статистика
`communications`	22	Вопросы, отзывы, чаты
`tariffs`	5	Комиссии, тарифы на доставку
`analytics`	17	Воронка продаж, поисковые запросы, остатки
`reports`	24	Заказы, продажи, остатки, маркировка
`finance`	12	Баланс, отчёты, эквайринг, документы
`wbd`	12	Цифровые товары, ключи активации

Примеры поиска

Code

wb_search("новые заказы fbs")
wb_search("баланс")
wb_search("отзывы", domain="communications")
wb_search("download report", domain="reports")

CLI

bash

# MCP-сервер (по умолчанию, без аргументов)
mcp-server-wildberries

# Все доступные команды
mcp-server-wildberries --help

# Справка по конкретной команде
mcp-server-wildberries fbs-orders --help

# Примеры команд
mcp-server-wildberries ping
mcp-server-wildberries seller-info
mcp-server-wildberries fbs-orders-new
mcp-server-wildberries tariff-commissions
mcp-server-wildberries fbs-orders --date-from 2025-01-01 --limit 10
mcp-server-wildberries advert-campaign-rename 12345 "Новое название"
mcp-server-wildberries analytics-csv-download dl_abc report.csv

# Версия
mcp-server-wildberries --version

Пример

bash

$ WB_TOKEN=ваш-токен mcp-server-wildberries ping
{"TS": "2026-05-06T18:06:30Z", "Status": "OK"}

$ WB_TOKEN=ваш-токен mcp-server-wildberries seller-info
{"name": "ИП Иванов И.И.", "sid": "...", "tradeMark": "MyBrand"}

Pydantic-модели

Модели параметров доступны как отдельная библиотека для использования в своих Python-программах:

Terminal

pip install mcp-server-wildberries

server.ts

from mcp_server_wildberries.models import FbsOrdersParams, SubjectsListParams

params = FbsOrdersParams(date_from="2025-01-01", limit=50)
# params.model_dump() → {"date_from": "2025-01-01", "date_to": "", "limit": 50, ...}

62 Pydantic-модели покрывают параметры всех 235 действий. Полный список — в src/mcp_server_wildberries/models.py.

Разработка

Terminal

pip install -e ".[test]"
ruff check src/ tests/
pytest tests/ -v

Лицензия

MIT

Read the full README →View source on GitHub →

Related MCP Servers

View all in Developer Tools View all alternatives

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Wildberries

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "wildberries": { "command": "npx", "args": ["-y", "wildberries"] } }

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/wildberries?style=directory)](https://allmcps.com/mcp/wildberries)

HTML Embed

<a href="https://allmcps.com/mcp/wildberries"><img src="https://allmcps.com/api/badge/wildberries?style=directory" alt="Wildberries on AllMCPs" /></a>

Technical Specs & Signals

CategoryDeveloper Tools

37Quality signal: Fair · 37/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools16/30

Adoption & activity2/15

Community engagement0/10

★ Featured

Moxie Docs MCP

MCP & Agent Skills for Automated Documentation, and codebase conventions + context

Explore Server →

Own this project?

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💻 Developer Tools →Best MCP servers for Developers →Alternatives to Wildberries →Install in Claude Desktop Install in Cursor Install in VS Code