marketplaces-mcp-ru
MCP servers for Wildberries, Ozon, Yandex Market and Avito seller accounts via official APIs with write confirmation
Install
uvx marketplaces-mcp-ruRuns the combined server from PyPI; keys via environment variables or *_add_cabinet tools.
This is third-party code. Review the repository files before installing.
What it does
The package runs five MCP servers on a shared core: Wildberries, Ozon Seller, Ozon Performance, Yandex Market and Avito. Instead of hundreds of separate tools, the agent searches a method catalog in Russian or English, reads the description and calls it, with typed tools for common tasks such as sales. Sales, orders, stock, prices, finance and reviews come from account APIs by token, without a browser. Each method is tagged read, write or destructive: writes need explicit confirmation and deletions need two. Built-in workflows help with reordering, price audits, ABC analysis and review digests, and multiple shops are supported.
Who it is for. For marketplace sellers and their managers running several platforms at once.
Good fit when
- You want a week of Wildberries and Ozon sales compared in one request
- You need to see which products to reorder based on stock and sales
- You need low-rated reviews collected and grouped by product
Not a fit when
- You need market analytics on other sellers' products without your own account
- You cannot give the agent account API keys with write rights
Example request
Show this week's sales on WB and Ozon, compare them and calculate days of stock coverLimitations
Requires API keys for your own accounts: a Wildberries token, Ozon Client-Id and Api-Key, a Yandex Market Api-Key, and Avito client_id and client_secret. The author marks the project alpha: the sales, stock, price, finance and review core is hand-verified, the other methods are imported from specs. The Docker HTTP mode has no built-in auth.
How to disable. Remove the server from the client MCP config or the extension from Claude Desktop, then delete ~/.marketplace-mcp with stored keys and revoke the keys in the seller accounts.
MCP
- Transport
- stdio, http
- Authentication
- API key
| Environment variables | |
|---|---|
| WB_API_TOKEN secret | Wildberries API token |
| OZON_CLIENT_ID | Ozon Client-Id |
| OZON_API_KEY secret | Ozon Api-Key |
| YANDEX_MARKET_API_KEY secret | Yandex Market Api-Key |
| AVITO_CLIENT_ID | Avito API client_id |
| AVITO_CLIENT_SECRET secret | Avito API client_secret |
| MCP_TRANSPORT | http enables Streamable HTTP instead of stdio |
Security check
- Can change prices, stock and orders in seller accounts
- Stores account API keys locally
- Methods outside the verified core are imported from specs and not hand-checked
README in short
The README explains why going through account APIs beats a browser and gives sample questions for the agent. It covers install options: a .mcpb extension for Claude Desktop, an installer skill, a release archive with installer, uvx, npx, VS Code and Cursor buttons, and Docker. It explains where to get keys, the doctor check, method risk levels and how meta-tools work over the catalog. MIT licensed.
FAQ
Can the agent change prices by accident?
Write methods need confirm_write=true, and deletions need an extra confirmation. CI checks that no modifying method is tagged as read.
Can I install a single marketplace?
Yes, there are separate ozon-mcp-ru, wildberries-mcp-ru, yandex-market-mcp-ru and avito-mcp-ru packages on the same core.
Where are keys stored?
Locally in ~/.marketplace-mcp/cabinets.json with owner-only permissions, or in environment variables.
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