Ozon MCP
ozon-mcp
MCP server for Ozon Seller API and Performance API: method search, calls guarded against accidental writes and ready analytics workflows
Install
git clone https://github.com/PCDCK/ozon-mcp.git
cd ozon-mcp
uv syncRequires Python 3.12+ and uv.
This is third-party code. Review the repository files before installing.
What it does
Instead of hundreds of separate tools the server gives the agent a compact set: search over Seller and Performance API methods in Russian or English, method docs with schema, examples and limits, a generic call and automatic pagination. Every method is tagged read, write or destructive; writes need an explicit confirmation flag and destructive methods need two. The server accounts for the cabinet subscription tier, retries on 429 and queues calls to strictly limited endpoints. It includes ready workflows such as out-of-stock risk analysis from turnover data.
Who it is for. For Ozon sellers and analysts who want to work with the seller cabinet through an agent.
Good fit when
- You need all products, stocks or prices without handling pagination
- You want to find products at risk of going out of stock
- You need to figure out which API method fits a task and what its limits are
Not a fit when
- You need Wildberries or other marketplaces
- The agent must not hold a key that can change prices and products
Example request
Run the oos_risk_analysis workflow and show products that will run out of stock within a weekLimitations
It needs a seller Client-Id and Api-Key, plus separate Performance API keys for ad stats. The server installs from a clone with uv and needs Python 3.12 or 3.13. API specs are a bundled snapshot that ages over time. Some methods are available only on higher Ozon subscription tiers.
How to disable. Run claude mcp remove ozon or delete the ozon block from the client config. API keys can be revoked in seller cabinet settings.
MCP
- Transport
- stdio
- Authentication
- API key
| Environment variables | |
|---|---|
| OZON_CLIENT_ID required | Seller cabinet Client-Id |
| OZON_API_KEY required, secret | Seller API Api-Key |
| OZON_PERFORMANCE_CLIENT_ID | Performance API client ID |
| OZON_PERFORMANCE_CLIENT_SECRET secret | Performance API secret |
Security check
- Can change prices, products and stocks in the seller cabinet
- Requires secret Seller API keys
- Performance API ad methods involve spending budget
README in short
The README starts with requirements and installation via uv, then gives configs for popular MCP clients. Examples show fetching all products and a stock analysis workflow with real response shapes. It describes the tools, the error format, method safety classes and how to refresh the spec snapshot. MIT license.
FAQ
Can the agent change prices by accident?
Writes need the confirm_write flag, and destructive methods also need i_understand_this_modifies_data. Calls without them are refused.
Which clients are supported?
The README gives configs for Claude Desktop, Claude Code, Cursor, Windsurf, Cline, Continue and a generic stdio client.
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