How do I use @theyahia/wildberries-mcp?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@@theyahia/wildberries-mcp list new orders" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

@theyahia/wildberries-mcp

by theYahia

Overview Schema Related Servers Score Discussions

TypeScript

Remote

@theyahia/wildberries-mcp

MCP server for the Wildberries Seller API — 30 tools across products, prices, stocks, orders, sales, FBS supplies, analytics, feedbacks, questions, returns, and ads. Per-category host routing with rate limiting and 409 penalty protection. Stdio + Streamable HTTP transports.

npm License: MIT

Quick Start

npm install -g @theyahia/wildberries-mcp

# stdio transport (for Claude Desktop, Cursor, etc.)
WB_API_TOKEN=your_token wildberries-mcp

# Streamable HTTP transport
WB_API_TOKEN=your_token wildberries-mcp --http

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "wildberries": {
      "command": "npx",
      "args": ["-y", "@theyahia/wildberries-mcp"],
      "env": { "WB_API_TOKEN": "your_token_here" }
    }
  }
}

Cursor / Windsurf / VS Code (Copilot) use the same mcpServers block in their MCP settings.

Smithery

npx @smithery/cli install @theyahia/wildberries-mcp

Related MCP server: Wildberries MCP Server

Authentication & token scopes

Authorization: Bearer {WB_API_TOKEN} (JWT, 180-day validity). Get your token in the seller portal under Settings → Access to API.

A single token can carry multiple category scopes. Because each tool talks to a different API host, a token missing a scope returns 401 from that host while other tools keep working. Enable the scopes you need:

Scope	Powers tools
Content	`list_products`, `get_product`
Prices & discounts	`update_prices`
Marketplace	`update_stocks`, `get_stocks`, `get_orders`, `get_new_orders`, `get_warehouses`, `get_supply`, `create_supply`, `add_orders_to_supply`, `deliver_supply`, `get_supply_barcode`
Statistics	`get_sales`, `get_incomes`, `get_fbw_stocks`, `get_statistics`, `get_abc_analysis`
Analytics	`get_funnel`, `get_paid_storage`
Tariffs (Common)	`get_commission`, `get_tariffs`
Feedbacks & questions	`get_feedbacks`, `reply_feedback`, `get_questions`, `reply_question`
Returns	`get_returns`
Advertising	`get_balance`, `list_campaigns`, `get_campaign_stats`

When a call fails, the error message names the host and includes WB's requestId, so a missing scope or wrong-host issue is obvious (e.g. WB API GET advert-api.wildberries.ru/adv/v1/balance → 401: ...).

Architecture — per-category hosts

The Wildberries Seller API is not a single gateway. seller.wildberries.ru is the web cabinet; the API is split across category hosts. Every request is routed to the right one:

Category	Host
Content	`content-api.wildberries.ru`
Prices & discounts	`discounts-prices-api.wildberries.ru`
Marketplace (FBS)	`marketplace-api.wildberries.ru`
Statistics	`statistics-api.wildberries.ru`
Analytics	`seller-analytics-api.wildberries.ru`
Common / Tariffs	`common-api.wildberries.ru`
Feedbacks & questions	`feedbacks-api.wildberries.ru`
Returns	`returns-api.wildberries.ru`
Advertising	`advert-api.wildberries.ru`

Tools (30)

Products & content

Tool	Method	Host · Endpoint
`list_products`	POST	content · `/content/v2/get/cards/list`
`get_product`	POST	content · `/content/v2/get/cards/detail`
`update_prices`	POST	prices · `/api/v2/upload/task`
`update_stocks`	PUT	marketplace · `/api/v3/stocks/{warehouseId}`
`get_stocks`	POST	marketplace · `/api/v3/stocks/{warehouseId}`

Orders & sales

Tool	Method	Host · Endpoint
`get_orders`	GET	marketplace · `/api/v3/orders`
`get_new_orders`	GET	marketplace · `/api/v3/orders/new`
`get_sales`	GET	statistics · `/api/v1/supplier/sales`
`get_incomes`	GET	statistics · `/api/v1/supplier/incomes`
`get_fbw_stocks`	GET	statistics · `/api/v1/supplier/stocks`

Warehouses & FBS supplies

Tool	Method	Host · Endpoint
`get_warehouses`	GET	marketplace · `/api/v3/offices`
`get_supply`	GET	marketplace · `/api/v3/supplies`
`create_supply`	POST	marketplace · `/api/v3/supplies`
`add_orders_to_supply`	PATCH	marketplace · `/api/v3/supplies/{id}/orders/{orderId}`
`deliver_supply`	PATCH	marketplace · `/api/v3/supplies/{id}/deliver`
`get_supply_barcode`	GET	marketplace · `/api/v3/supplies/{id}/barcode`

Analytics

Tool	Method	Host · Endpoint
`get_statistics`	GET	statistics · `/api/v5/supplier/reportDetailByPeriod`
`get_abc_analysis`	GET	statistics · `reportDetailByPeriod` (computed Pareto)
`get_funnel`	POST	analytics · `/api/v2/nm-report/detail`
`get_paid_storage`	GET	analytics · `/api/v1/paid_storage` (async report)

Pricing reference

Tool	Method	Host · Endpoint
`get_commission`	GET	common · `/api/v1/tariffs/commission`
`get_tariffs`	GET	common · `/api/v1/tariffs/box`

Feedbacks & questions

Tool	Method	Host · Endpoint
`get_feedbacks`	GET	feedbacks · `/api/v1/feedbacks`
`reply_feedback`	PATCH	feedbacks · `/api/v1/feedbacks`
`get_questions`	GET	feedbacks · `/api/v1/questions`
`reply_question`	PATCH	feedbacks · `/api/v1/questions`

Returns & ads

Tool	Method	Host · Endpoint
`get_returns`	GET	returns · `/api/v1/claims`
`get_balance`	GET	advert · `/adv/v1/balance`
`list_campaigns`	GET	advert · `/adv/v1/promotion/count`
`get_campaign_stats`	POST	advert · `/adv/v2/fullstats`

Rate limiting

Wildberries meters requests per API category, not as one global pool — and returns 409 as a penalty for bursts. The client keeps one token-bucket limiter per host plus finer buckets for the strictest endpoints:

Per-host token buckets with a minimum interval between requests.
409 penalty handling: reads X-Ratelimit-Retry-After / X-Ratelimit-Remaining, deducts penalty tokens, and waits the indicated duration before retrying — penalties stay isolated to the offending category.
Strict per-endpoint caps (paid-storage create/download 1/min, status 1/5s; prices ~10/6s).

The defaults are deliberately conservative and safe to raise once you've observed your account's real limits. No configuration needed.

Configuration

Variable	Required	Description
`WB_API_TOKEN`	yes	Wildberries Seller API token (JWT).
`WB_TIMEOUT_MS`	no	Per-request timeout in ms (default 30000).
`PORT`	no	HTTP port when running with `--http` (default 3000).

HTTP endpoints (--http): POST /mcp (requests), GET /health ({ status, version, tools }).

Demo prompts

"List the first 50 products in my catalog with current prices." "Run an ABC analysis for the last 30 days — which products make 80% of revenue?" "Create an FBS supply 'Morning 2026-06-23', attach orders 1001 and 1002, then close it for delivery and get its barcode." "Show unanswered questions and draft a reply to the first one." "What's my advertising balance and which campaigns are active?"

Development

git clone https://github.com/theYahia/wildberries-mcp.git
cd wildberries-mcp
npm install
npm run build
npm test

License

MIT — see LICENSE.

Install Server

license - permissive license

quality

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Related MCP Servers

MoySklad MCP Server
CRM E-commerce & Retail
theYahia
A
license
C
quality
B
maintenance
MCP server for MoySklad (МойСклад) warehouse and CRM management API. 21 tools covering the full order lifecycle: products, stock, counterparties, customer orders, shipments, supplies, warehouses, organizations, reports, and webhooks.
Last updated 2026-06-23
60
93
4
MIT
Wildberries MCP Server
E-commerce & Retail Search
kulichevskiy
F
license
-
quality
D
maintenance
MCP server for Wildberries API that enables fetching product cards with multi-cabinet support, automatic pagination, and retry logic.
Last updated 2026-03-26
1
marketplaces-mcp-ru
E-commerce & Retail Finance Marketing
ilyautov
A
license
A
quality
A
maintenance
AI-доступ к кабинетам Wildberries и Ozon через MCP-сервера над Seller API. Обеспечивает 793 метода для управления продажами, остатками, ценами, финансами, отзывами и рекламой с safety-гейтом и авто-пагинацией.
Last updated 2026-08-01
58
11
MIT
wildberries-mcp
E-commerce & Retail Web Scraping
shndo1337
F
license
-
quality
C
maintenance
MCP server that turns Wildberries marketplace into a toolkit for LLM agents, enabling product search, detailed card inspection, price history, reviews, and cross-product comparison.
Last updated 2026-07-08

View all related MCP servers

Related MCP Connectors

DataDoe MCP
Hosted Amazon Seller and Vendor MCP server for Claude, ChatGPT, Cursor, Codex, Gemini, Copilot.
agentcentral
Hosted Amazon Seller Central and Amazon Ads MCP server for Claude, ChatGPT, Cursor, and agents.
Wavix
Hosted MCP server for the Wavix telecom platform: SMS, voice, 2FA, SIP, numbers, 10DLC, CDRs.

View all MCP Connectors

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/theYahia/wildberries-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server

@theyahia/wildberries-mcp

Quick Start

Claude Desktop

Smithery

Authentication & token scopes

Architecture — per-category hosts

Tools (30)

Products & content

Orders & sales

Warehouses & FBS supplies

Analytics

Pricing reference

Feedbacks & questions

Returns & ads

Rate limiting

Configuration

Demo prompts

Development

License

Maintenance

Resources

Looking for Admin?

Tools

Related MCP Servers

MoySklad MCP Server

Wildberries MCP Server

marketplaces-mcp-ru

wildberries-mcp

Related MCP Connectors

Latest Blog Posts

MCP directory API