Ozon Seller MCP server
mcp-ozon-seller
MCP server for the Ozon Seller API: products, prices, stock, FBO and FBS orders, analytics and seller finance
Install
{
"mcpServers": {
"ozon-seller": {
"command": "npx",
"args": ["-y", "@woyax/mcp-ozon-seller"],
"env": {
"OZON_CLIENT_ID": "123456",
"OZON_API_KEY": "your-api-key-here"
}
}
}
}Local stdio mode. The same config works for Cursor.
This is third-party code. Review the repository files before installing.
What it does
Connects an agent to an Ozon seller account through the Seller API. It offers 26 tools: product cards, price and stock updates, FBO and FBS orders, sales analytics, finance reports, returns and seller rating. It runs locally over stdio or as an HTTP server on your own VPS, including for n8n.
Who it is for. Ozon sellers and integrators who want to manage a store and pull reports with plain requests to an agent.
Good fit when
- You want revenue, orders or stock without opening the seller portal
- You need to bulk update prices or FBS stock
- You want to check finance reports, accruals and returns for a period
- You want to add Ozon operations to n8n workflows
Not a fit when
- You cannot issue an API key with the Admin role
- You plan to resell it as a hosted service: the Commons Clause license requires the author's permission
Example request
Show my revenue and order count for the last 7 days and list products that are out of stockLimitations
All 26 tools need a key with the Admin role. Ozon rate limits apply: the server retries on 429, and get_warehouse_stocks has stricter limits. In HTTP mode credentials are passed as URL parameters, so keep the server behind HTTPS on a private network. License is MIT + Commons Clause.
How to disable. Remove the ozon-seller block from mcpServers in the client config and revoke the key in Ozon Seller if you no longer need it.
MCP
- Transport
- stdio, http
- Authentication
- API key
| Environment variables | |
|---|---|
| OZON_CLIENT_ID required | Numeric seller ID from the Ozon seller account |
| OZON_API_KEY required, secret | API key (UUID) from the Ozon seller account with the Admin role |
| MCP_TRANSPORT | Transport: stdio (default) or http |
| MCP_PORT | Port for HTTP mode, default 3000 |
Security check
- Requires a Seller API key with the Admin role
- Tools change prices, stock and product cards in a live store
- In HTTP mode the key is passed in the URL
README in short
The server provides 26 tools in seven groups: account, products, prices and stock, orders, analytics, finance, returns and rating. It supports local stdio for Claude Desktop and Cursor and remote HTTP for self-hosting and n8n. The README covers getting a key in Ozon Seller, environment variables and sample prompts. It is part of the Woyax AI Stack for Russian businesses.
FAQ
Can several sellers use one server?
Yes, in HTTP mode credentials are passed per request, so multiple users can connect at once.
What about 429 errors?
The server retries with exponential backoff of 1, 2 and 4 seconds. Avoid calling get_warehouse_stocks in tight loops.
Related
153 cross-border e-commerce skills via the LinkFox API: Amazon, Ozon, TikTok Shop, 1688, keywords, ads and patents
Bitrix24 for OpenClaw
OpenClaw Bitrix24
OpenClaw plugin and skill: the agent chats in Bitrix24 Messenger and works with CRM, tasks, calendar and drive
An Avito Business API skill: a full OpenAPI spec with 245 operations, an OAuth2 helper and an endpoint lookup CLI