Installs the server marketplaces-mcp-ru: 1022 methods of the official Seller APIs in a single
catalog.
| marketplace | methods | tool prefix |
|---|---|---|
| Ozon Seller | 441 | ozon_ |
| Wildberries | 307 | wb_ |
| Yandex Market | 165 | ym_ |
| Avito | 64 | avito_ |
| Ozon Performance (advertising) | 45 | ozon_perf_ |
The catalog is stored in YAML and executed by the server, so the agent gets several universal tools per marketplace rather than a separate function for each method.
Installation
uvx marketplaces-mcp-ru
Client configuration (Claude Desktop, Cursor, Claude Code):
{
"mcpServers": {
"marketplaces-ru": {
"command": "uvx",
"args": ["marketplaces-mcp-ru"],
"env": {
"WB_API_TOKEN": "<токен Wildberries, необязательно>",
"OZON_CLIENT_ID": "<client id Ozon, необязательно>",
"OZON_API_KEY": "<api key Ozon, необязательно>",
"YANDEX_MARKET_API_KEY": "<ключ Яндекс Маркета, необязательно>",
"AVITO_CLIENT_ID": "<client id Авито, необязательно>",
"AVITO_CLIENT_SECRET": "<client secret Авито, необязательно>"
}
}
}
}
The variables for those marketplaces a person does not sell on are simply not specified: the server will come up and work with the rest.
Where to get the keys
- Wildberries:
seller.wildberries.ru, Settings → API access. - Ozon:
seller.ozon.ru, Settings → API keys, both halves of the pair are needed. - Yandex Market:
partner.market.yandex.ru, Settings → API. - Avito: For business → Integrations → API, the pair is exchanged for a token via OAuth2.
The second path, without environment variables: start the server and call
<префикс>_add_cabinet. The keys will go into ~/.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.ozon_describe_method(...): parameters, pagination, access class.ym_call_method(...): call. Reads go through immediately, writes ask for confirmation, irreversible ones ask twice.avito_check_auth: check that the keys arrived.
How to behave
First search for the method using the catalog, do not guess the name. Before writing, show the person exactly what will be sent 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 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.
When aggregating data across multiple marketplaces, keep the source for each row: platforms have different definitions of a sale, an order, and a return, and silently summing them produces a beautifully wrong number.
Only one marketplace
If you need exactly one account, there are separate packages with the same catalog:
ozon-mcp-ru, wildberries-mcp-ru, yandex-market-mcp-ru, avito-mcp-ru.