ozon-seller-mcp: all 482 Ozon Seller API methods for an agent

ozon-seller-mcp

A Node.js MCP server covers all Ozon Seller API methods with schema validation, six composite queries and a read-only mode

  • 0 ★ on the repository
  • Last commit
MCP server

Extended access

Why this level

  • An Ozon seller key opens products, stock, orders and finances, and with OZON_READ_ONLY=false also changing them
  • On large stores composite queries hit Ozon limits and run slowly
All reasons and checks
Russian stack

mrsxs/ozon-seller-mcp

Install

Services

In your terminal, with SkillFoxx CLI

npx skillfoxx add mcp/mrsxs-ozon-seller-mcp

Detects the agents on your machine, shows the access level and pins the version.

Other ways to install

Access and checks

How we review

Extended accessThe tool runs code or makes network calls and only reads external data.

  • An Ozon seller key opens products, stock, orders and finances, and with OZON_READ_ONLY=false also changing them
  • On large stores composite queries hit Ozon limits and run slowly

This is third-party code. Review the repository files before installing.

What it does

The server runs through `npx` and works over stdio. It covers 482 methods from the official Russian-language OpenAPI specification and validates parameters against the schema before sending. By default 25 tools are exposed, and the `OZON_TOOLSET` setting widens the set to all methods. Six composite tools answer common questions in one call: a product ranking by sales and revenue, a product list and a product card, stock, orders and a sales overview. By default the server only reads: writes are enabled with `OZON_READ_ONLY=false`, and a typo in the value stops the launch. The fields `customer`, `addressee`, `address`, `phone`, `email` and `legal_info` are stripped from results. Ozon limits go into tool descriptions and results, and repeated reads are cached for five minutes. The `ozon-seller-assistant` skill formats answers into tables and offline HTML reports.

Who it is for. Ozon sellers and marketplace analysts who want to ask questions about products, stock and orders in plain language.

Good fit when

  • You need a store product ranking by sales and revenue with prices, stock and attributes
  • Stock for the whole store is summarised into a list of zero and low stock items
  • FBS and FBO shipments are grouped by status and cancellation reasons for a period
  • The answer is needed as an offline HTML report with search, sorting and CSV export

Not a fit when

  • You need the buyer side of Ozon without a seller cabinet: the server works only with the Seller API
  • You need a Python server: this one is Node.js 20.18 or newer
  • You need customer data such as address and phone: the server strips such fields from results

Example request

Show the top 20 store products by revenue for the month with stock and build an offline report

MCP

Transport
stdio
Authentication
API key

Environment variables

OZON_CLIENT_ID required
Ozon seller Client ID
OZON_API_KEY required, secret
Ozon seller API key
OZON_READ_ONLY
Read-only mode, true by default
OZON_TOOLSET
Toolset: core, minimal or all

Limitations

It needs Node.js 20.18 or newer, an Ozon seller Client ID and API Key, and for the Ozon Delivery group a separate `OZON_ACCESS_TOKEN`. Documentation and error messages are mostly in Chinese. Ozon limits are strict: sales analytics allows 1 request per minute and 50 per day. Composite queries on large stores take up to 11 seconds. No license is stated in the repository. One author, version 2.1.0, the last commit in October 2026, no stars.

How to disable. Remove the `ozon-seller` entry from MCP client settings and create a new API key in the Ozon cabinet to revoke the old one.

FAQ

How do I enable writes in the store?

Set `OZON_READ_ONLY=false`. Any value other than `true` and `false` stops the launch so a typo does not open writing.

How many tools does the agent see?

25 by default: composite, general and the most frequent methods. The `minimal` and `all` values of `OZON_TOOLSET` narrow the set or open all 482 methods.

Which data is stripped from replies?

The `customer`, `addressee`, `address`, `phone`, `email` and `legal_info` fields, including warehouse addresses and phones. The API key never appears in results or errors.

What about Ozon rate limits?

Limits are shown in tool descriptions and in the `rate_limit` result field. A repeated read within five minutes comes from the cache, and the server never retries a write.

How do I check that the server works?

Call the `ozon_status` tool: it shows the mode, the toolset, the Node version and whether keys are set, without printing their values.

Discussion

No questions or reviews yet.

Ozon MCP

ozon-mcp

Russian stack

MCP server for Ozon Seller API and Performance API: method search, calls guarded against accidental writes and ready analytics workflows

MCP serverBroad access26Repository stars
Russian stack

An MCP server for the Ozon Seller API with a catalog of 441 methods, read and write access classes, and keys stored outside the repository

MCP serverBroad access3Repository stars

Ozon Seller MCP server

mcp-ozon-seller

Russian stack

MCP server for Ozon Seller API: products, prices, stocks, FBO and FBS orders, seller analytics and finances

MCP serverBroad access7Repository stars
Russian stack

MCP server for the Ozon Seller and Performance APIs: prices, promotions, ads, orders, returns and finance across several stores

MCP serverBroad access11Repository stars
Russian stack

An MCP server with 9 read-only tools over the Ozon Seller API v3: products, FBS and FBO orders, analytics, finance and returns

MCP serverExtended access
Russian stack

A Go MCP server for the Ozon Seller API with 68 tools: catalog, prices, stock, promotions, analytics, finance, FBS and FBO, read-only by default

MCP serverBroad access

Comparison with similar tools

Cards that share the main search query, and how they differ.

ToolOfficialAuthenticationRepository starsMain difference
ozon-seller-mcp: all 482 Ozon Seller API methods for an agent (this card)noAPI key0
Ozon Seller API MCP servernoAPI key4the same task flow, but with the full specification snapshot and composite queries
marketplaces-mcp-runokey is optional62Ozon Seller API only, but all 482 methods and personal field protection

README in short

The README lists capabilities, client setup, environment variables, composite and general tools, Ozon limits, parameter validation, privacy rules and the development flow.

README badge

Report a problem