Installs the server ozon-mcp-ru: 441 methods of the official API
(190 read, 240 write, 11 irreversible). The method catalog is stored in YAML and
executed by the server, so the agent gets several universal
tools rather than a separate function for each method.
Installation
The package is on PyPI, so it's a one-liner:
uvx ozon-mcp-ru
If you need the branch mainrather than the release:
uvx --from git+https://github.com/ilyautov/ozon-mcp-ru ozon-mcp-ru
Client configuration (Claude Desktop, Cursor, Claude Code):
{
"mcpServers": {
"ozon": {
"command": "uvx",
"args": ["ozon-mcp-ru"],
"env": {
"OZON_CLIENT_ID": "<значение>",
"OZON_API_KEY": "<значение>"
}
}
}
}
Where to get the keys
OZON_CLIENT_ID: Client-Id from the seller.ozon.ru account, Settings → API keys.OZON_API_KEY: Api-Key from the same pair. Both go into the headers of the same names.
The second path, without environment variables: start the server and call
ozon_add_cabinet. The keys will be stored in ~/.marketplace-mcp/cabinets.json
with permissions 600 and do not leave the machine. A second store connects the same way.
What to ask the server
ozon_search_methods("остатки по складам"): search for a method by words.ozon_describe_method(...): parameters, pagination, access class.ozon_call_method(...): call. Reads go through immediately, writes ask for confirmation, irreversible ones ask twice.ozon_check_auth: check that the keys arrived.
How to behave
First search for the method using the catalog, don't guess the name. Before writing, show the person what exactly 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 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.
The Ozon advertising account is a separate API with different authorization. It is also in marketplaces-mcp-ru, the command ozon-perf-mcp, 45 methods.
All four marketplaces at once
If you need not only Ozon Seller, the combine marketplaces-mcp-ruis installed:
Wildberries, Ozon, Yandex Market and Avito in one server.