Wildberries MCP server
MCP server for Wildberries Seller API — products, orders, supplies, analytics, advertising
2 stars31 downloads/wk
Reviews
Write oneNobody has reviewed Wildberries yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Wildberries tools (100, 21 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
wb_advert_balanceGet advertising account balance.
wb_advert_bid_recommendationsGet bid recommendations. Args: campaign_id.
wb_advert_bids_updatewrite actionUpdate advertising bids. Args: params_json (JSON array).
wb_advert_budgetGet advertising campaign budget. Args: campaign_id.
wb_advert_budget_depositReplenish campaign budget. Args: campaign_id, amount.
wb_advert_campaign_createwrite actionCreate advertising campaign. Args: params_json (JSON object).
wb_advert_campaign_deletewrite actionDelete advertising campaign. Args: campaign_id.
wb_advert_campaign_pausePause advertising campaign. Args: campaign_id.
wb_advert_campaign_renameRename advertising campaign. Args: campaign_id, name.
wb_advert_campaign_startStart advertising campaign. Args: campaign_id.
wb_advert_campaign_stopStop advertising campaign. Args: campaign_id.
wb_advert_campaignsGet advertising campaign details. Args: campaign_ids_json (JSON array of IDs).
wb_advert_campaigns_countGet advertising campaign counts by type.
wb_advert_cost_historyGet advertising cost history. Args: date_from, date_to.
wb_advert_min_bidsGet minimum bid rates. Args: params_json (JSON object).
wb_advert_minus_phrasesGet negative phrases. Args: params_json (JSON object).
wb_advert_minus_phrases_setSet negative phrases. Args: params_json (JSON object).
wb_advert_nmsGet product cards for advertising. Args: params_json (JSON object).
wb_advert_nms_updatewrite actionManage product cards in campaign. Args: params_json (JSON object).
wb_advert_paymentsGet advertising payment history. Args: date_from, date_to.
wb_advert_placements_updatewrite actionUpdate advertising placements. Args: params_json (JSON object).
wb_advert_search_bidsGet search cluster bids. Args: params_json (JSON object).
wb_advert_search_bids_deletewrite actionDelete search cluster bids. Args: params_json (JSON object).
wb_advert_search_bids_setSet search cluster bids. Args: params_json (JSON object).
wb_advert_search_statsGet search cluster statistics. Args: params_json (JSON object).
wb_advert_subjectsGet available categories for advertising.
wb_analytics_csv_createwrite actionCreate analytics CSV report. Args: params_json (JSON object).
wb_analytics_csv_downloadDownload analytics CSV report. Args: download_id, output_path.
wb_analytics_csv_listGet list of analytics CSV reports.
wb_analytics_csv_retryRetry CSV report generation. Args: params_json (JSON object).
wb_analytics_sales_funnelGet product sales funnel. Args: params_json (JSON object).
wb_analytics_sales_funnel_groupedGet grouped sales funnel history. Args: params_json (JSON object).
wb_analytics_sales_funnel_historyGet daily/weekly sales funnel history. Args: params_json (JSON object).
wb_analytics_search_detailsGet search query details. Args: params_json (JSON object).
wb_analytics_search_groupsGet search query groups. Args: params_json (JSON object).
wb_analytics_search_ordersGet orders by search phrase. Args: params_json (JSON object).
wb_analytics_search_reportGet search queries report. Args: params_json (JSON object).
wb_analytics_search_textsGet search phrases for product. Args: params_json (JSON object).
wb_analytics_stocks_groupsGet grouped inventory data. Args: params_json (JSON object).
wb_analytics_stocks_officesGet warehouse inventory data. Args: params_json (JSON object).
wb_analytics_stocks_productsGet product inventory data. Args: params_json (JSON object).
wb_analytics_stocks_sizesGet inventory by size. Args: params_json (JSON object).
wb_analytics_stocks_wbGet WB warehouse stock data. Args: params_json (JSON object).
wb_chat_eventsGet chat events.
wb_chat_sendwrite actionSend chat message. Args: chat_id, text.
wb_chatsGet chats list.
wb_content_brandsGet brands. Args: pattern (search filter).
wb_content_cards_errorsGet card upload errors.
wb_content_cards_listGet product cards list. Args: cursor_json (JSON), filter_json (JSON).
wb_content_cards_updatewrite actionUpdate product cards. Args: cards_json (JSON array of card objects).
wb_content_characteristicsGet subject characteristics. Args: subject_id.
wb_content_colorsGet color directory.
wb_content_countriesGet country of origin directory.
wb_content_kindsGet gender directory.
wb_content_parent_categoriesGet parent categories.
wb_content_seasonsGet season directory.
wb_content_subjectsGet all subjects (categories) with IDs. Args: name (filter), top, offset.
wb_content_tag_createwrite actionCreate tag. Args: name, color.
wb_content_tag_deletewrite actionDelete tag. Args: tag_id.
wb_content_tag_linkLink tag to products. Args: nm_ids_json (JSON array of nmIDs), tag_id.
wb_content_tag_updatewrite actionUpdate tag. Args: tag_id, name, color.
wb_content_tagsGet seller tags.
wb_content_tnvedGet TNVED codes for subject. Args: subject_id.
wb_content_vatGet VAT rates.
wb_dbs_b2b_infoGet DBS B2B buyer info. Args: order_ids_json (JSON array).
wb_dbs_clientGet DBS client info. Args: order_ids_json (JSON array).
wb_dbs_delivery_dateGet DBS delivery dates. Args: order_ids_json (JSON array).
wb_dbs_groups_infoGet DBS paid delivery info. Args: order_ids_json (JSON array).
wb_dbs_order_cancelwrite actionCancel DBS order. Args: order_ids_json (JSON array).
wb_dbs_order_confirmwrite actionConfirm DBS order. Args: order_ids_json (JSON array).
wb_dbs_order_deliverwrite actionMove DBS order to delivery. Args: order_ids_json (JSON array).
wb_dbs_order_metawrite actionGet DBS order metadata. Args: order_ids_json (JSON array).
wb_dbs_order_meta_deletewrite actionDelete DBS order metadata. Args: order_ids_json (JSON array).
wb_dbs_order_meta_sgtinwrite actionSet Honest Sign codes for DBS orders. Args: orders_json (JSON array).
wb_dbs_order_meta_uinwrite actionSet UIN for DBS orders. Args: orders_json (JSON array).
wb_dbs_order_receivewrite actionConfirm DBS order receipt. Args: order_ids_json (JSON array).
wb_dbs_order_rejectwrite actionRecord DBS order rejection. Args: order_ids_json (JSON array).
wb_dbs_ordersGet completed DBS orders.
wb_dbs_orders_newGet new DBS orders.
wb_dbs_orders_statusGet DBS order statuses. Args: order_ids_json (JSON array).
wb_dbs_stickersGet DBS stickers. Args: order_ids_json (JSON array).
wb_feedbackGet individual review. Args: feedback_id.
wb_feedback_answerAnswer review. Args: feedback_id, text.
wb_feedback_answer_editEdit review answer. Args: feedback_id, text.
wb_feedback_pinPin review. Args: feedback_id, nm_id.
wb_feedback_pinsGet pinned reviews for product. Args: nm_id.
wb_feedback_pins_countGet pinned review count for product. Args: nm_id.
wb_feedback_pins_limitsGet pinning limits.
wb_feedback_returnRequest return for review. Args: feedback_id.
wb_feedback_unpinUnpin review. Args: feedback_id, nm_id.
wb_feedbacksGet reviews list. Args: is_answered, take, skip.
wb_feedbacks_archiveGet archived reviews. Args: take, skip.
wb_feedbacks_countGet review count for period. Args: date_from, date_to.
wb_feedbacks_unanswered_countGet count of unprocessed reviews.
wb_new_feedbacks_questionsGet count of unread questions and reviews.
wb_questionGet individual question. Args: question_id.
wb_question_manageManage question (answer, reject, view). Args: question_id, action (wbRu/none/declined), answer.
wb_questionsGet questions list. Args: is_answered, take, skip.
wb_questions_countGet question count for period. Args: date_from, date_to.
wb_questions_unanswered_countGet count of unanswered questions.
Public scan report
scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it
- Code scan23 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 140 days ago8/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How Wildberries compares
Against every graded E-commerce MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 72/100
- higher than 45% of 2,174 E-commerce servers
- Tools
- 100
- the typical E-commerce server has 6
- Tools that change things
- 21%
- typical: 0%. Fewer write tools means less an agent can break
- GitHub stars
- 2
- more than 80% of 1,047 E-commerce servers
- Downloads a week
- 31
- more than 23% of 411 E-commerce servers with a package
What its tools let an agent do: 79 read · 21 change
Install Wildberries in Claude Code, Cursor or VS Code
claude mcp add wildberries -- uvx mcp-server-wildberries
What the publisher says
From the Wildberries repository's README, as published. We do not edit it. Read it on GitHub
mcp-server-wildberries
mcp-name: io.github.dontsovcmc/wildberries
MCP-сервер для Wildberries Seller API — товары, заказы, поставки, аналитика, реклама, финансы.
235 действий, покрывающих все разделы WB API.
Построен по официальной документации Wildberries API.
Архитектура
Сервер использует паттерн search + execute — вместо 235 отдельных инструментов предоставляет 3:
Это экономит токены в контексте LLM — схемы 3 инструментов вместо 235.
Как это работает
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
Установка:
pip install mcp-server-wildberriesПодключение к Claude Code (токен в командной строке):
claude mcp add wildberries -e WB_TOKEN=ваш-токен -- mcp-server-wildberriesПодключение к Claude Code (токен из .env файла):
source .env && claude mcp add wildberries -e WB_TOKEN -- mcp-server-wildberriesУдаление MCP-сервера:
claude mcp remove wildberriesCLI без Claude (токен в командной строке):
WB_TOKEN=ваш-токен mcp-server-wildberries pingCLI без Claude (токен из .env файла):
source .env && mcp-server-wildberries pingWindows
Установка:
pip install mcp-server-wildberriesПодключение к Claude Code (токен в командной строке):
set WB_TOKEN=ваш-токен && claude mcp add wildberries -e WB_TOKEN -- mcp-server-wildberriesПодключение к Claude Code (токен из .env файла):
for /f "tokens=1,2 delims==" %a in (.env) do set %a=%b
claude mcp add wildberries -e WB_TOKEN -- mcp-server-wildberriesУдаление MCP-сервера:
claude mcp remove wildberriesCLI без Claude (токен в командной строке):
set WB_TOKEN=ваш-токен && mcp-server-wildberries pingCLI без Claude (токен из .env файла):
for /f "tokens=1,2 delims==" %a in (.env) do set %a=%b
mcp-server-wildberries pingЗапуск через uvx (без установки)
Если не хотите устанавливать пакет глобально, используйте uvx — он скачает и запустит автоматически:
# Подключение к 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-строки:
claude --mcp-config '{"wildberries":{"command":"bash","args":["-c","source ~/.env.mcp && exec uvx mcp-server-wildberries"]}}'Из файла:
claude --mcp-config ~/mcp-servers.jsonТолько указанные серверы, без сохранённых:
claude --strict-mcp-config --mcp-config ~/mcp-servers.jsonПример ~/mcp-servers.json:
{
"wildberries": {
"command": "bash",
"args": ["-c", "source ~/.env.mcp && exec uvx mcp-server-wildberries"]
}
}Пример ~/.env.mcp:
WB_TOKEN=ваш-токенПлюсы:
- Токены в отдельном файле .env.mcp, а не в настройках Claude
- Один файл mcp-servers.json на все проекты — легко делиться конфигом в команде
- --strict-mcp-config — запуск с точным набором серверов, без лишних
- Не засоряет глобальные настройки при экспериментах
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Wildberries: common questions
- Is Wildberries MCP server safe?
- Mostly: it is graded B (72/100). Read the Wildberries safety report
- How do I install Wildberries?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Wildberries need an API key?
- Yes. The registry entry asks for
WB_TOKEN. - Is Wildberries maintained?
- The last commit was 178 days ago (2026-05-10). The latest release is v0.1.1.
- What can I use instead of Wildberries?
- Servers from other publishers that do the same job: Mercado Libre MCP server, TikTok Shop MCP server and PostHog MCP Server.
- How does Wildberries compare with other E-commerce MCP servers?
- safety score 72/100 (higher than 45% of 2,174 E-commerce servers); tools 100 (the typical E-commerce server has 6); tools that change things 21% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to Wildberries
Same job from other publishers: the closest match first, then the best rated.
- Mercado LibreMercado Libre — LATAM marketplace, product search, orders, sellers, shipmentsnot reviewedGrowingB
- TikTok ShopRead-only TikTok Shop Partner API: orders, finance, products and analytics across shops.not reviewedGrowingA
- PostHog MCP ServerOfficial PostHog MCP Server for product analytics, feature flags, experiments, and more.not reviewedEstablishedA
- WebCake StorefrontBuild pages and manage products, orders, and content on the WebCake/StoreCake storefront builder.not reviewedGrowingA
- HasData AmazonAmazon keyword search, product details, seller profiles and seller catalogues, as structured JSON.not reviewedGrowingA