Wildberries MCP
wildberries-mcp
MCP server for the Wildberries seller API: products, prices, stock, orders, FBS supplies, analytics, reviews and ads
Install
{
"mcpServers": {
"wildberries": {
"command": "npx",
"args": ["-y", "@theyahia/wildberries-mcp"],
"env": { "WB_API_TOKEN": "your_token_here" }
}
}
}Add to claude_desktop_config.json. Cursor, Windsurf and VS Code use the same block.
This is third-party code. Review the repository files before installing.
What it does
The server connects a Wildberries seller account to the agent through 30 tools. The agent reads product cards, orders, sales, WB warehouse stock, sales reports, the funnel and paid storage, and runs ABC analysis. It can also change prices and stock, create FBS supplies and add orders to them, and reply to reviews and questions. Each request goes to the host of its API category, and the built-in rate limiter handles 409 penalties per category. The repo ships three simple Claude Code skills: today's orders, sales analytics and low-stock products.
Who it is for. For Wildberries sellers and their managers who want to query the seller account in plain language.
Good fit when
- You need a sales summary and ABC analysis for a period
- You need products that are running out of stock
- You need to work through unanswered questions and reviews
Not a fit when
- Price and stock changes must never happen without manual review
- You need competitor analytics rather than your own account
Example request
Run an ABC analysis for the last 30 days and show the products that bring 80% of revenueLimitations
Requires a seller API token with the right access categories; tokens last 180 days. Tools of a missing category return 401. Write tools change real prices, stock and supplies. Unofficial project, part of the author's WWmcp series.
How to disable. Delete the wildberries block from your MCP client config and, if installed globally, run npm uninstall -g @theyahia/wildberries-mcp.
MCP
- Transport
- stdio
- Authentication
- API key
| Environment variables | |
|---|---|
| WB_API_TOKEN required, secret | Wildberries seller API token (JWT) |
| WB_TIMEOUT_MS | Request timeout in milliseconds, 30000 by default |
| PORT | Port for --http mode, 3000 by default |
Security check
- Changes prices and stock in a live seller account
- Creates and closes FBS supplies and publishes review replies
- Holds the seller API token
README in short
The Russian README covers a quick start via npm, a Claude Desktop config and Smithery installation. It maps each tool to the token category it needs and lists the Wildberries API hosts. A section explains how the server respects rate limits and handles 409 penalties. It ends with sample prompts and development commands. MIT licensed.
FAQ
Why do some tools return 401?
The token lacks that access category. The error names the host, which tells you which category to enable.
Can it run over HTTP?
Yes, with --http it serves Streamable HTTP on the PORT variable, 3000 by default.
Related
Salesforce's official DX MCP server: work with orgs, metadata, data, users and Apex tests from your agent
E-Commerce Skills
E-Commerce Skills by Nexscope
A large set of text skills for Amazon, Shopify, eBay, Etsy, TikTok Shop and Walmart sellers: pricing, listings, ads and growth
153 cross-border e-commerce skills via the LinkFox API: Amazon, Ozon, TikTok Shop, 1688, keywords, ads and patents
An MCP server for Bitrix24 CRM contacts and deals via an inbound webhook: search, lists and deal stage changes