Registered WB shops (магазины): shop_id + name. Use shop_id in all other tools.

[P0] Cards with errors: blocked/rejected, incl. IP-holder complaints (заблокированные карточки). Check regularly.

List product cards (карточки товаров), cursor pagination.

Card details by nmID (карточка товара).

Update cards: description, SEO, characteristics (обновить карточку).

Move cards to trash by nmID (удалить карточки).

Restore cards from trash by nmID (восстановить карточки).

Card create/edit limits (лимиты карточек).

Create new cards, async, up to 30 min to sync. Get subject characteristics via wb_subject_charcs first (создать карточки).

Cards in trash (корзина).

Generate barcodes for new goods (баркоды).

Upload photo/video to a card by URL. Warning: REPLACES all existing media (медиа, фото).

Search WB subjects/categories for card creation (предметы, категории).

Subject characteristics: required/optional card fields (характеристики предмета).

WB reference books: colors, kinds, countries, seasons, vat, tnved (справочники).

Seller tags for grouping cards (ярлыки, теги).

Attach/detach tags on a card. Pass the FULL new tag list (привязать ярлык).

Create a tag; color is HEX (создать ярлык).

Update a tag: name, color (обновить ярлык).

Delete a tag. Fails if still linked to goods — unlink via wb_tag_link first (удалить ярлык).

Recommended goods on a card, cross-sell (рекомендации).

Set recommended goods on a card, max 10 nmID (рекомендации, средний чек).

Seller brands; subject_id filters by category (бренды).

[P0] Current prices and discounts for all goods (цены, скидки, маржинальность).

[P0] Set prices and discounts. Items: {nmID, price, discount} (установить цену).

[P0] Goods in price quarantine: cut over 3x, new price NOT applied (карантин цен). Check regularly.

Set WB Club discounts, max 1000 goods per request (скидка WB Клуба).

Price upload status by uploadID from wb_prices_set. buffer=true for deferred uploads (статус загрузки цен).

Prices per size for one product (цены по размерам).

Set B2B wholesale discounts: {nmID, wholesaleDiscount} (оптовые скидки).

[P0] WB promotions for a period. type: 'auto' = WB adds goods itself, 'regular' (акции, промо). Monitor auto ones.

[P0] Auto-promotions only (type=auto): WB adds goods without asking (автоакции). Regular monitoring keeps prices from dropping.

[P0] Participation audit: which promotions already hold my goods and the price effect (price→planPrice, % drop). For auto-promos WB hides the item list (nomenclaturesAvailable=false) — control prices via wb_prices_list/wb_prices_quarantine. Auto-throttled to 10 req/6 s (аудит акций).

Promotion details: dates, ranging/boost conditions, slots, participationPercentage, advantages, type (детали акции).

Goods eligible for a promotion. in_action: true = participating. Returns price/planPrice, discount/planDiscount (товары акции).

Add goods to a promotion. upload_now=false defers until start. Returns uploadID (вступить в акцию).

[P0] Leave a promotion: restore price and discount via Prices API, WB has no exit endpoint (выйти из акции).

[P0] Realization report for a period: commissions, logistics, storage, penalties, payout (отчёт о реализации, прибыль). Use wb_finance_reports_list + wb_finance_report_detailed for detail.

[P0] Realization reports list, finance-api v1, data from 2025-01-01. Then call wb_finance_report_detailed (список отчётов).

[P0] Realization report detail by reportId: commissions, logistics, storage, penalties, payout. Paginate via rrd_id (детализация отчёта).

Acquiring cost reports, card payment fees (эквайринг).

Acquiring cost detail for a period (эквайринг, детализация).

[P0] Ad campaigns with settings and bids. statuses: 9=active, 11=paused, 7=finished, 4=ready, 8=cancelled, -1=deleted (реклама, кампании).

Campaign counts by type and status; use to get all campaign IDs (количество кампаний).

Create ad campaign (type 9 Search+Catalog, the only one since 2026). bid_type: unified | manual with placement_types (создать кампанию).

[P0] Campaign stats: spend, views, clicks, CTR, CPC, orders, revenue + daily breakdown in days[]. Limit 3 req/min, period ≤31 d. Spend/revenue over 20% means ДРР too high (статистика рекламы).

Ad account balance: account, balance, bonuses (баланс рекламы).

Budget of one ad campaign (бюджет кампании).

Top up campaign budget. source: 0=account, 1=balance, 3=bonuses (пополнить бюджет).

Ad spend history for a period (затраты на рекламу).

[P0] Emergency pause of an ad campaign, e.g. when ДРР over 20% (остановить рекламу).

Start an ad campaign (запустить рекламу).

Finish an ad campaign for good, unlike pause (завершить кампанию).

Delete an ad campaign, irreversible (удалить кампанию).

[P0] Change CPM/CPC bids. Bids in KOPECKS. placement: search | recommendations | combined for unified (ставки).

Recommended bids for a card in a campaign (рекомендованные ставки).

[P0] Search clusters of a campaign, replaced keyword phrases in 2026 (поисковые кластеры, запросы, SEO).

Search cluster stats for a period; daily=true for per-day rows (статистика кластеров).

Set bids on specific search clusters. Bid in RUBLES per 1000 views (ставки на кластеры).

Campaign minus-phrases: read without norm_queries, set with them. WB has no plus-phrases since 2026 (минус-фразы).

Ad account top-up history for a period, dates YYYY-MM-DD (пополнения счёта).

Rename an ad campaign (переименовать кампанию).

Merge/split cards, max 30 nmID. target_imt set = merge into that imtID, unset = split (объединить карточки).

Add a nomenclature/size to an existing card by imtID (добавить размер).

All parent product categories (родительские категории).

Upload media as a FILE by URL, server downloads and sends. photo_number from 1, video = 1 (загрузить фото файлом).

FBS order meta/marking; available keys come from the order's requiredMeta (маркировка заказа).

[P0] Set FBS order marking: meta_type = sgtin|uin|imei|gtin|expiration. Only in status confirm (маркировка, Честный знак).

Delete FBS order meta by key: imei|uin|gtin|sgtin (удалить маркировку).

Order status history, cross-border, max 100 (история статусов).

Buyer data for cross-border orders from Turkey (данные покупателя).

Orders that need reshipment (повторная отгрузка).

Cross-border delivery stickers, max 100, status complete (стикеры доставки).

Archived FBS orders for a period: finished or cancelled (архив заказов).

Assembly task IDs inside an FBS supply (задания в поставке).

Offices/warehouses that require a pass (офисы, пропуска).

Active warehouse passes (пропуска).

Create a warehouse pass, valid 48 h (создать пропуск).

Update a warehouse pass (обновить пропуск).

Delete a warehouse pass (удалить пропуск).

Boxes (trbx) of an FBS supply (короба поставки).

Add boxes to a supply, amount 1..1000, pickup points only while assembling (добавить короба).

Delete boxes from a supply (удалить короба).

Box QR stickers: svg|zplv|zplh|png (стикеры коробов).

New DBS orders awaiting assembly (новые DBS-заказы).

Finished DBS orders, Unix timestamps, ≤30 days, cursor next (DBS-заказы).

DBS order statuses, max 1000 (статусы DBS).

DBS buyer data, after confirm (покупатель DBS).

Delivery date/time chosen by the DBS buyer, max 1000 (дата доставки).

Paid delivery cost by groupId, max 1000 (стоимость доставки).

[P0] Change DBS order status: action = confirm|deliver|receive|reject|cancel. receive/reject need the buyer code (статус DBS-заказа).

DBS order meta (метаданные DBS).

DBS order marking: sgtin|uin|imei|gtin, status confirm (маркировка DBS).

Delete DBS order meta by key (удалить маркировку DBS).

New click-and-collect tasks (новые задания самовывоза).

Finished click-and-collect tasks, Unix timestamps, ≤30 days (задания самовывоза).

Click-and-collect task statuses (статусы самовывоза).

Buyer data, statuses confirm/prepare (покупатель самовывоза).

[P0] Verify the buyer code when handing over a click-and-collect order (код покупателя).

[P0] Change click-and-collect status: action = confirm|prepare|receive|reject|cancel (статус самовывоза).

Click-and-collect task meta (метаданные самовывоза).

Click-and-collect marking: sgtin|uin|imei|gtin, status confirm (маркировка самовывоза).

Delete click-and-collect meta by key (удалить маркировку).

Brand share in a category, ≤365 days. Needs parentId and brand from the brand_share_parents/brands tools (доля бренда).

Seller brands sold in the last 90 days, input for brand-share (бренды для доли).

Parent categories of a brand, input for brand-share (категории бренда).

Sales by region, ≤31 days, YYYY-MM-DD (продажи по регионам).

Chestny Znak excise/labeling report. Limit 10 req per 5 hours (Честный знак, КиЗ).

Item rating: card views, cart adds, orders, conversions. Jam subscription. Low conversion signals a card or price problem. Max 1000 nmID (рейтинг товаров, конверсия).

Sales funnel by product groups, per day, compares periods (воронка по группам).

Per-nmID report: revenue, orders, returns, conversions. Task-based, waits up to 3 min, kept 3 days (отчёт по номенклатуре).

Stock and turnover report split by size, finds dead sizes (остатки по размерам, неликвид).

Search analytics per product: positions and conversions by query. Requires Jam (поисковая аналитика).

Search analytics by group: subject, brand, tag. Requires Jam (поисковая аналитика по группам).

Orders and positions by search query for a product, ≤7 days. Requires Jam (заказы по запросам).

Flags for unseen feedbacks/questions: hasNewFeedbacks, hasNewQuestions (новые отзывы и вопросы).

Complain about a feedback or report a product problem, codes from supplier-valuations (жалоба на отзыв).

Archived feedbacks, previously answered, unlike wb_feedbacks_list (архив отзывов).

Pinned feedbacks shown first on the card (закреплённые отзывы).

Pinned feedback count, limit 3 per nmID (число закреплённых).

Pin feedbacks, max 3 per nmID (закрепить отзывы).

Unpin feedbacks (открепить отзывы).

One buyer question by ID (вопрос покупателя).

Request a product return from a feedback, only if isAbleReturnProductOrders=true (возврат по отзыву).

Feedback count for a period, Unix ts, isAnswered filter (число отзывов за период).

Question count for a period, Unix ts, isAnswered filter (число вопросов за период).

Subjects available for ad campaigns (предметы для рекламы).

Goods available for campaigns, by subject IDs (товары для рекламы).

WB Jam subscription state: active, expiry. Check before Jam-only tools (подписка Джем).

[P0] Box logistics tariffs for FBO; tariff growth eats margin (тарифы логистики).

Pallet logistics tariffs for FBO (тарифы палет).

[P0] Reverse logistics tariffs for returns, a hidden cost at high return rates (тарифы возвратов).

[P0] WB commissions by category for FBO, FBS, DBS; input for unit economics (комиссии). Pass subject to filter: the full reference is 7 400 categories.

Transit directions for FBW supplies to regions (транзитные тарифы). Temporarily disabled by WB itself.

[P0] Paid storage report; goods with no sales and high storage cost are direct losses (платное хранение).

Sales funnel per product: views, clicks, cart, orders, revenue, conversions, vs previous period. Limit 3 req/min (воронка продаж).

Sales funnel BY DAY, last week at most, for conversion trends (воронка по дням).

Interactive stock and turnover report: healthy, scarce and dead goods (остатки, оборачиваемость).

Stock report split by WB warehouse. Task-based, 10-60 s (остатки по складам).

Deductions for self-buyouts, published on Wednesdays (удержания за самовыкупы).

Paid acceptance report at WB warehouses. Task-based, 10-60 s (платная приёмка).

[P0] Blocked or shadowed cards hidden from the catalogue — lost sales (заблокированные товары).

Deductions for substitutions and wrong contents (удержания за подмены). Both dates are required: WB rejects the call without date_from.

[P0] Search query report: views, clicks, search positions. Requires Jam. Limit 3 req/min (поисковые запросы, видимость).

Top search queries for specific goods, max 30 without Jam (поисковые фразы).

[P0] Seller balance: payable, in transit. Token needs the Finance category (баланс продавца).

Seller info: name, profile ID. Works with any token (информация о продавце).

New FBS orders awaiting assembly (новые заказы).

All orders for a period (заказы за период).

Statuses of specific orders (статусы заказов).

Cancel an FBS assembly task, irreversible (отменить заказ).

Stickers for FBS assembly tasks, max 100. Formats: svg, zplv, zplh, png (стикеры заказов).

Create an FBS supply to ship assembled orders (создать поставку).

FBS supply info (детали поставки).

Add assembly tasks to an FBS supply, max 100, tasks move to confirm (добавить заказы в поставку).

Close an FBS supply and hand it to delivery, tasks move to complete (закрыть поставку).

FBS supply QR code for warehouse handover (QR поставки).

Delete an empty active FBS supply (удалить поставку).

Sales for a period; spots goods that stopped selling (продажи).

Order statistics including cancellations; for cancel and return analysis (заказы, отмены).

[P0] Current stock across ALL WB warehouses (API cap 1000, default 100). nm_ids filters by article. Stock without sales means overpaid storage (остатки).

Feedback list. Unanswered negatives cut rating and conversion (отзывы).

Count of unanswered feedbacks (неотвеченные отзывы).

Reply to a feedback; edit=true rewrites an existing reply (ответить на отзыв).

Seller rating of the shop (рейтинг продавца).

Buyer questions list (вопросы покупателей).

Count of unanswered questions (неотвеченные вопросы).

Reply to a buyer question; reject=true declines it (ответить на вопрос).

Buyer return claims. is_archive=false = pending, NEED an answer; true = archive. actions[] lists allowed actions (возвраты, заявки).

Answer a return claim. action strictly from the claim's actions[]: approve1 (defect check at WB), approve2 (take the item back), autorefund1 (refund without return), reject1/reject2/reject3 (WB refusal templates), rejectcustom (needs comment) (ответ на возврат).

Analytics report on goods returned to the seller, max 31 days (отчёт по возвратам).

Seller warehouses (склады продавца).

Create a seller warehouse for FBS (создать склад).

Update a seller warehouse (обновить склад).

Delete a seller warehouse (удалить склад).

Supplies list (поставки).

Update FBS stock. Field names are not validated: a typo returns 204 with no update (обновить остатки).

Get FBS stock by barcodes (остатки FBS).

Delete FBS stock records by SKU, zeroing them (удалить остатки).

FBW supplies to WB warehouses, read-only; creation lives in the seller portal (поставки FBW).

FBW supply details (детали поставки FBW).

Goods inside an FBW supply (товары в поставке).

Warehouses and packaging types available for an FBW supply, by barcodes (варианты приёмки).

WB warehouses for FBW supplies (склады FBW). Temporarily disabled by WB itself — returns an explanation, not data.

[P0] Warehouse acceptance coefficients for 14 days; coefficient 0 or 1 with allowUnload=true means acceptance is open, x2-x7 multiplies the cost (коэффициенты приёмки). Temporarily disabled by WB itself.

Buyer chats, includes replySign for answering. May hold complaints and IP-holder claims (чаты с покупателями).

Chat events, new messages. Cursor pagination: first call without next, then next from the response (события чатов).

Send a message to a buyer chat, ≤1000 chars. reply_sign comes from wb_buyer_chats (написать покупателю).

Download a file from a buyer chat; file_id comes from a chat event (файл из чата).

Document categories: reconciliation acts, УПД, invoices (категории документов).

Seller financial documents: acts, УПД, notices. Needed for accounting (документы, бухгалтерия).

Download one document, PDF/XML, by ID (скачать документ).

Download several documents in one request by IDs (скачать документы).

[P0] Full self-diagnostics: ping all WB API hosts, light real requests per category, token analysis (expiry, scopes). Run FIRST when a tool misbehaves — separates a token problem from a category or WB API change (диагностика).

Token info for a shop: scopes, expiry, read-only/sandbox. No WB requests (информация о токене).

Tool degradations: which MCP tools used to work and now fail steadily, signalling a WB API change. No parameters (деградации).

WB seller news including API change announcements; check for integration-breaking changes (новости API).