Installs the server wildberries-mcp-ru: 307 methods of the official API
(187 read, 108 write, 12 irreversible). The method catalog lives in YAML and
is executed by the server, so the agent gets several universal
tools rather than a separate function for each method.
Installation
The first release on PyPI is published with the tag v0.5.3, before that the package is installed directly from the repository:
uvx --from git+https://github.com/ilyautov/wildberries-mcp-ru wildberries-mcp-ru
After the release the line is shorter:
uvx wildberries-mcp-ru
Client configuration (Claude Desktop, Cursor, Claude Code):
{
"mcpServers": {
"wb": {
"command": "uvx",
"args": ["--from", "git+https://github.com/ilyautov/wildberries-mcp-ru", "wildberries-mcp-ru"],
"env": {
"WB_API_TOKEN": "<значение>"
}
}
}
}
Where to get the keys
WB_API_TOKEN: Token from the seller.wildberries.ru dashboard, Settings → API Access. It goes into Authorization without Bearer.
The second path, without environment variables: start the server and call
wb_add_cabinet. The keys will land in ~/.marketplace-mcp/cabinets.json
with permissions 600 and do not leave the machine. A second store is connected the same way.
What to ask the server
wb_search_methods("остатки по складам"): search for a method by words.wb_describe_method(...): parameters, pagination, access class.wb_call_method(...): call. Reads go through immediately, writes ask for confirmation, irreversible ones ask twice.wb_check_auth: check that the keys arrived.
How to behave
First search for the method using the catalog, don't guess the name. Before a write, show the person exactly what will go to the API, and wait for consent: the gate will trigger anyway, but the person must see the request body before, not after.
Do not round the numbers from the response or recalculate them in your head. If the method returned an empty list, say so, instead of explaining it on the seller's behalf.
All four marketplaces at once
If you need more than just Wildberries, install the combine marketplaces-mcp-ru:
Wildberries, Ozon, Yandex Market and Avito in one server.