OpenAPI-driven Wildberries MCP server
Wildberries MCP Server
A local Wildberries Seller API MCP server built from a 279-method OpenAPI catalog, with calls defaulting to dry-run
High risk
We rate an entry high when the tool writes to external systems, handles money, production databases or secrets, or runs arbitrary commands. The CLI installs it only with your consent.
Why this level
- The catalog covers write operations on orders, prices and content, reachable through an explicit allow_write flag
- wb_raw_request allows calling arbitrary endpoints outside the catalog
Install
Manual install
git clone https://github.com/Jerardx/wildberries-mcp-server.gitClone the repo, then set up a virtual environment and install requirements.txt.
This is third-party code. Review the repository files before installing.
What it does
The server is a thin adapter over a shared wb_client.py: auth, rate limits, 429 retry and write protection live in one place, while the MCP layer only exposes tools to the agent. A catalog built from Wildberries OpenAPI specs covers 279 operations across analytics, communications, finance, FBS, DBS, DBW and FBW orders, products, promotion, reports and tariffs, with a known rate limit for every method. The agent first finds the right method via wb_search_methods or a ready wb_get_recipe business recipe, reads its description with wb_describe_method, and calls it with wb_call_method or wb_raw_request. Every call defaults to dry_run, and a real write requires an explicit allow_write.
Who it is for. For developers and sellers who want full Wildberries Seller API coverage with a safe dry-run before a real write.
Good fit when
- You need the full Wildberries Seller API method catalog with a known rate limit for each one
- You want the agent to dry-run a call before writing any data
- You want ready business recipes for sales, stock or FBS orders
Not a fit when
- You need a packaged release rather than a source install from what the README calls a private repository
- You only need a handful of operations, not the full 279-method catalog
Example request
Find the Wildberries method for warehouse stock and show its rate limitLimitations
The README itself calls the repository private, and install is source-only via git clone and a Python virtual environment. No license is stated. Secrets and real business exports are excluded from the repo; you need your own token.
How to disable. Remove the wildberries entry from your MCP client configuration.
MCP
- Transport
- stdio
- Authentication
- API key
| Environment variables | |
|---|---|
| WILDBERRIES_API required, secret | A Wildberries seller token |
Security check
- The catalog covers write operations on orders, prices and content, reachable through an explicit allow_write flag
- wb_raw_request allows calling arbitrary endpoints outside the catalog
README in short
The README lists the repo's contents, current coverage of 279 operations and 279 wrapper scripts with zero methods missing a rate limit, install steps via a virtual environment and .env, connecting as an MCP server for a generic client, Claude Desktop, Cursor, Windsurf and Hermes Agent, the list of MCP tools, and a recommended call order for the agent.
FAQ
Can the agent write data to Wildberries right away?
No, calls default to dry_run; a real write needs an explicit allow_write.
How does the agent find the right method among 279?
Via wb_search_methods by description, or via wb_get_recipe with a ready Russian business scenario.
Related
Salesforce's official DX MCP server: work with orgs, metadata, data, users and Apex tests from your agent
Yandex Kit skills for store management
kit-skills
Yandex's official skill set: catalog, prices, stock, orders, storefront and a weekly checkup for a Yandex Kit store, through Claude Code or Codex
YouGile MCP by Indalo
YouGile MCP
Full 65-operation YouGile API coverage with configurable permissions, write confirmation and a shared company rate limit
Bitrix24 portal MCP server
MCP-сервер портала Битрикс24
Bitrix24's official per-portal MCP: an external agent uses OAuth or a token to read and change tasks, deals, meetings and mail