Connector guide7-minute read34 MCP tools7 languages

Wildberries MCP Server: Orders, Stock and Sales

Run a Wildberries seller account from an AI agent: FBS orders and their statuses, seller warehouses and stock levels, statistics on orders and sales, stock on WB warehouses, the sales report detail, product cards and prices, product feedbacks and buyer questions with answers, and buyer return claims. 34 tools across the WB API hosts, one API token.

HCBy HelpCode teamUpdated 7 min read Open-source on GitHub

No credit card · 7-day trial · Self-host alternative available

Wildberries

Wildberries

Run a Wildberries seller account from an AI agent: FBS orders and their statuses, seller warehouses and stock levels, statistics on orders and sales, stock on WB warehouses, the sales report detail, product cards and prices, product feedbacks and buyer questions with answers, and buyer return claims. 34 tools across the WB API hosts, one API token.

tools

34

Region

INTL

Category

E-commerce

Authentication

API Key

Required env vars

WILDBERRIES_API_TOKEN
Install in one click on Cloud

7-day free trial · No credit card

  • 7-day free trial
    No credit card required
  • GDPR & SOC 2 ready
    EU data residency, audit logs
  • Open-source on GitHub
    Open source · AGPL-3.0
  • Works with ChatGPT, Claude, Gemini
    Any MCP-compatible client

Summary

Run a Wildberries seller account from an AI agent: FBS orders and their statuses, seller warehouses and stock levels, statistics on orders and sales, stock on WB warehouses, the sales report detail, product cards and prices, product feedbacks and buyer questions with answers, and buyer return claims. 34 tools across the WB API hosts, one API token.

Guided setup

Connect Wildberries to Claude, ChatGPT or Copilot in 2 minutes

Start a free trial on AnythingMCP Cloud, connect Wildberries in the guided setup, then add your MCP URL to your AI assistant. No code and no server to run.

No credit card · 7-day trial · Self-host alternative available

Try asking

Example prompts for Wildberries

Click any prompt to copy it. Paste into Claude, ChatGPT, Cursor, Gemini, Copilot or OpenClaw to run it against this connector.

Wildberries · live via MCP
Share
Opus 4.7

Claude is AI and can make mistakes. Please double-check responses.

💡 No install? Use cloud.anythingmcp.com directly. Sign in, click Connectors → Wildberries, paste your credentials, mint an MCP API key and you're done. No Docker, no git clone, no local server.

Wildberries

Run a Wildberries seller account from an AI agent: FBS orders and their statuses, seller warehouses and stock levels, statistics on orders and sales, stock on WB warehouses, the sales report detail, product cards and prices, product feedbacks and buyer questions with answers, and buyer return claims. 34 tools across the WB API hosts, one API token.

Setup

One token covers every tool; each tool calls the right Wildberries API host by itself.

  1. In the seller portal, open Settings → API integrations (Настройки → Доступ к API) and click Create token.
  2. Choose the Base token type. Wildberries says Personal tokens must not be used in cloud services. A Base token has lower limits on several methods (see below).
  3. Tick the categories you need: Marketplace (FBS orders, warehouses, stock), Statistics, Analytics (stock on WB warehouses), Finance (sales report), Content (product cards), Prices and Discounts, Feedbacks and Questions and Buyers Returns. Choose Read only unless the AI should update stock or prices, answer feedbacks and questions, or decide on returns.
  4. Copy the token, which is shown once, into WILDBERRIES_API_TOKEN without Bearer. It is valid for 180 days; create a new one before it expires.
  5. Call wildberries_ping to check the token, then wildberries_list_new_orders for the FBS orders waiting to be packed.

A 401 means the token is wrong or expired; a 403 means it lacks the category for that part of the API.

Feedbacks, questions and returns: the AI counts the feedbacks and buyer questions still waiting for an answer, lists them, drafts replies and publishes each one after you approve the text. Answers appear on the product page, and an answer can be changed once, within 60 days. Return claims of the last 14 days come with the decisions Wildberries allows for each one, and the AI sends the one you choose. A return decision cannot be undone. wildberries_reject_question is switched off at install.

Base token: 5 calls an hour for feedbacks and questions. With a Base token, all feedback and question calls together are limited to 5 an hour, one every 12 minutes, so only a few answers fit into an hour. Plan the batch with the AI: on a 429 it stops and picks up again after the wait time Wildberries gives. Return claims allow 1 call an hour with a Base token.

Other rate limits: Marketplace allows 300 requests a minute, and every 4xx answer counts as 10. Statistics on orders and sales: one call a minute, and only one every 3 hours with a Base token, so the AI calls them once with a start date and works from the result. Sales report detail: 2 a day with a Base token. Prices: 4 an hour with a Base token. On a 429, the wait time is in X-Ratelimit-Retry.

Stock on WB warehouses: wildberries_get_wb_warehouse_stocks answers 403 to a Base token. The report flow works instead: wildberries_create_stock_report, then wildberries_get_stock_report_status, then wildberries_download_stock_report.

Stock and prices: wildberries_update_stocks overwrites the stock amount (it does not add) and wildberries_set_prices changes live prices, so the AI confirms both with you. Read the stock back after an update: wrong field names still return 204 without changing anything.

Already installed? The feedback, question and return tools reach a connector you installed earlier through its catalog update: open the connector in AnythingMCP and, under Catalog update available, check the list of new tools and click Apply update. Your token and any tools you added yourself stay as they are, and wildberries_reject_question arrives switched off, as on a new install. Tick Feedbacks and Questions and Buyers Returns on the token, or create a new one, if they were not ticked before.

Prerequisites: WILDBERRIES_API_TOKEN

Install the connector locally

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Open http://localhost:3000/connectors/store, pick Wildberries and paste in the env vars listed under Prerequisites.

Available tools

ToolWhat it does
wildberries_pingCheck that the API token is valid and reaches the WB API
wildberries_get_seller_infoGet the seller account behind the token: legal name, seller id (sid), tax number and trade mark
wildberries_list_new_ordersList every new FBS assembly order (order to pack and ship from your own warehouse) that exists right now: id, nmId, chrtId, article, price…
wildberries_list_ordersList FBS assembly orders created in a period (at most 30 days per call, up to 3 months back), without their current status
wildberries_get_order_statusesGet the current status of up to 1000 FBS assembly orders by id: supplierStatus (new, confirm, complete, cancel), wbStatus (waiting, sorted…
wildberries_list_suppliesList FBS supplies (shipments that group assembly orders for hand-over to Wildberries): id, name, done, created and closed dates, cargo type
wildberries_list_warehousesList the seller's own warehouses (id, name, linked WB office, cargo and delivery type)
wildberries_list_wb_officesList Wildberries offices (WB warehouses and sorting centres) that a seller warehouse can be linked to: id, name, city, address…
wildberries_get_stocksRead the stock on one seller warehouse for up to 1000 product sizes
wildberries_update_stocksOverwrite the stock of up to 1000 product sizes on one seller warehouse
wildberries_list_statistics_ordersOrders statistics from the statistics host: one row per ordered unit with date, lastChangeDate, warehouse, region, article, nmId, barcode…
wildberries_list_statistics_salesSales and returns statistics: one row per sold or returned unit with saleID (S for sale, R for return), dates, warehouse, article, nmId…
wildberries_get_wb_warehouse_stocksCurrent stock on Wildberries warehouses (FBW), one row per product size per WB warehouse, updated every 30 minutes
wildberries_create_stock_reportStart generating the WB warehouses inventory report (stock per product on Wildberries warehouses), which also works with a Base token
wildberries_get_stock_report_statusCheck whether a WB warehouses inventory report task is ready
wildberries_download_stock_reportDownload a finished WB warehouses inventory report: per product (brand, subject, vendorCode, nmId, barcode, size) the quantity on each…
wildberries_get_sales_report_detailDetail lines of the sales (realisation) reports for a period: sales, returns, logistics, storage, fines and payouts per line, from 29…
wildberries_list_product_cardsList product cards (listings) with nmID, vendorCode, brand, title, subject, characteristics, photos and sizes (chrtID, barcodes)
wildberries_list_pricesList products with their prices: nmID, vendorCode, currency, discount, WB Club discount and per-size price and discounted price
wildberries_set_pricesSet prices and discounts for up to 1000 products in one upload
wildberries_get_price_upload_statusGet the state of a processed price and discount upload by its id: status, upload and activation dates, total and failed product counts
wildberries_get_card_limitsGet the free and paid limits for creating product cards
wildberries_count_unanswered_feedbacksCount the feedbacks (product reviews) still waiting for the seller's answer: countUnanswered over all time and countUnansweredToday
wildberries_count_unanswered_questionsCount the buyer questions still waiting for the seller's answer: countUnanswered over all time and countUnansweredToday
wildberries_check_new_feedbacks_questionsTell whether there are feedbacks or questions the seller has not seen yet (hasNewFeedbacks, hasNewQuestions)
wildberries_list_feedbacksList product feedbacks (reviews) with their id, text, pros, cons, rating (productValuation), product (nmId, name), date and the seller's…
wildberries_get_feedbackRead one feedback by its id: text, pros, cons, rating, photos, product and the seller's answer
wildberries_answer_feedbackPublish the seller's answer to a feedback; buyers see it on the product page
wildberries_edit_feedback_answerReplace the seller's published answer to a feedback
wildberries_list_questionsList buyer questions about products with their id, text, product (nmId, name), date and the seller's answer if any
wildberries_answer_questionAnswer a buyer question, or change an answer already given (once, within 60 days); the question is then shown with the answer on the…
wildberries_reject_questionReject a buyer question so it does not appear on the product page (state none)
wildberries_list_return_claimsList buyer return applications (claims) of the last 14 days: id, product (nm_id, imt_name), buyer comment, photos, status, dates and…
wildberries_answer_return_claimDecide on a buyer return application: send one of the values in the claim's actions array from wildberries_list_return_claims, such as…

Example prompts

  • "How many feedbacks and buyer questions are waiting for an answer today?"
  • "Draft friendly answers to the unanswered 4- and 5-star feedbacks and show them to me before publishing."
  • "Show the open return claims and the decisions I can take on each one."
  • "Which FBS orders are new right now, and how much stock of those sizes is left on my warehouse?"

Next steps

Was this guide helpful?

Connect Wildberries to Claude, ChatGPT or Copilot in 2 minutes

Start a free trial on AnythingMCP Cloud, connect Wildberries in the guided setup, then add your MCP URL to your AI assistant. No code and no server to run.

Related guides

Connectors

Connect Wildberries to Microsoft Copilot via MCP

Run a Wildberries seller account from an AI agent: FBS orders and their statuses, seller warehouses and stock levels, statistics on orders and sales, stock on WB warehouses, the sales report detail, product cards and prices, product feedbacks and buyer questions with answers, and buyer return claims. 34 tools across the WB API hosts, one API token.

Connectors

Connect Wildberries to ChatGPT via MCP

Run a Wildberries seller account from an AI agent: FBS orders and their statuses, seller warehouses and stock levels, statistics on orders and sales, stock on WB warehouses, the sales report detail, product cards and prices, product feedbacks and buyer questions with answers, and buyer return claims. 34 tools across the WB API hosts, one API token.

Connectors

Connect Wildberries to Claude via MCP

Run a Wildberries seller account from an AI agent: FBS orders and their statuses, seller warehouses and stock levels, statistics on orders and sales, stock on WB warehouses, the sales report detail, product cards and prices, product feedbacks and buyer questions with answers, and buyer return claims. 34 tools across the WB API hosts, one API token.

Connectors

Connect Wildberries to Cursor via MCP

Run a Wildberries seller account from an AI agent: FBS orders and their statuses, seller warehouses and stock levels, statistics on orders and sales, stock on WB warehouses, the sales report detail, product cards and prices, product feedbacks and buyer questions with answers, and buyer return claims. 34 tools across the WB API hosts, one API token.

Connectors

Connect Wildberries to Gemini CLI via MCP

Run a Wildberries seller account from an AI agent: FBS orders and their statuses, seller warehouses and stock levels, statistics on orders and sales, stock on WB warehouses, the sales report detail, product cards and prices, product feedbacks and buyer questions with answers, and buyer return claims. 34 tools across the WB API hosts, one API token.

Connectors

Connect Wildberries to Meta Muse via MCP

Run a Wildberries seller account from an AI agent: FBS orders and their statuses, seller warehouses and stock levels, statistics on orders and sales, stock on WB warehouses, the sales report detail, product cards and prices, product feedbacks and buyer questions with answers, and buyer return claims. 34 tools across the WB API hosts, one API token.