# Ozon Seller MCP Server [Health: Active]

**Category:** 🛒 E-Commerce  
**Repository:** https://github.com/woyaxnini/mcp-ozon-seller  
**GitHub Stars:** 7  
**npm Downloads (last month):** 234  
**Views:** 11  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/ozon-seller-mcp-server

## Description
MCP server for Ozon Seller API. 26 tools: products, prices, orders, analytics, finance, rating.

## Tools
Capabilities this server exposes over MCP:

- **get_seller_info** — Verify credentials, get account info
- **list_products** — List products with status filters
- **get_product** — Product card: attributes, status, images
- **create_product** — Create new products (up to 100 at once)
- **update_product** — Update product attributes and description
- **archive_product** — Hide product from storefront
- **unarchive_product** — Restore product to active sale
- **get_prices** — Current prices and price index
- **update_prices** — Update prices (up to 1000 products at once)
- **get_stocks** — Stock levels across all warehouses
- **update_stocks** — Update FBS warehouse stocks
- **list_fbo_orders** — List FBO orders
- **get_fbo_order** — FBO order details
- **list_fbs_orders** — List FBS orders
- **get_fbs_order** — FBS order details
- **get_fbs_awaiting** — FBS orders waiting to be shipped
- **get_analytics** — Sales, revenue, views, returns — any period
- **get_warehouse_stocks** — Ozon warehouse stocks with turnover data
- **get_finance_report** — Cash flow report for a period
- **list_transactions** — Transactions: accruals, commissions, payouts
- **get_transactions_totals** — Transaction summary totals
- **list_fbo_returns** — FBO returns: items, reasons, amounts
- **list_fbs_returns** — FBS returns: items, reasons, amounts
- **get_seller_rating** — Seller quality index
- **get_seller_rating_history** — Seller rating history over time
- **list_warehouses** — Seller warehouses (IDs needed for stock updates)

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "ozon-seller-mcp-server": {
    "command": "npx",
    "args": ["-y","@woyax/mcp-ozon-seller"],
    "env": {
      "OZON_CLIENT_ID": "",
      "OZON_API_KEY": ""
    }
  }
}
```

**Requires environment variables:** `OZON_CLIENT_ID`, `OZON_API_KEY` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What Ozon Seller MCP Server MCP server does

Ozon Seller MCP Server MCP server connects MCP-compatible clients to the Ozon Seller API. Its 26 tools cover account verification, product catalog operations, pricing, stock, FBO and FBS orders, analytics, finance, returns, warehouses, and seller ratings.

Product tools can list items by status, retrieve product cards, create up to 100 products in one operation, update product information, and archive or restore listings. Pricing tools read current prices and price indexes, while the update operation supports up to 1,000 products at once. Stock tools report inventory across warehouses and update FBS warehouse quantities.

Order tools distinguish between Ozon-fulfilled (FBO) and seller-fulfilled (FBS) orders. Agents can retrieve order lists and details, including FBS orders that are waiting to be shipped. Reporting tools provide sales, revenue, views, returns, warehouse stock turnover, cash flow, transaction records, and transaction totals. Separate tools expose FBO and FBS returns plus current and historical seller rating data.

## How it works

The server calls the Ozon Seller API using a numeric seller client ID and an API key. It can run locally over stdio or as an HTTP service. In local mode, an MCP client starts the package and passes credentials through environment variables. In HTTP mode, the server listens on a configured port, and credentials are supplied in the MCP request URL, allowing multiple users to connect with separate credentials.

Ozon API rate limits apply. The server retries HTTP 429 responses with exponential delays of 1, 2, and 4 seconds. The `get_warehouse_stocks` operation has stricter limits and should not be called repeatedly in a tight loop.

## Setup and configuration

To run Ozon Seller MCP Server MCP server, create a Seller API key in Ozon Seller under Settings, API Integrations, and Seller API. The documentation specifies the Admin role for all 26 tools. Save the numeric `Client-Id` and UUID-style `Api-Key` values.

For local use, configure the MCP client to run `npx -y @woyax/mcp-ozon-seller` and provide `OZON_CLIENT_ID` and `OZON_API_KEY`. The default transport is stdio. For HTTP mode, run the package with the HTTP transport and optionally set `MCP_PORT`; the documented default port is 3000. The resulting endpoint uses the `/mcp` path with `client_id` and `api_key` query parameters.

The README gives configuration examples for Claude Desktop and identifies Cursor as another local stdio client. It also describes connecting an n8n custom MCP node to the HTTP endpoint.

## Tools and capabilities

- Verify seller credentials and retrieve account information.
- Create, inspect, update, archive, and restore products.
- Read and change prices, including price-index data.
- Inspect warehouse stock and update FBS stock quantities.
- List and inspect FBO and FBS orders.
- Find FBS orders awaiting shipment.
- Query sales, revenue, views, returns, and warehouse turnover.
- Retrieve finance reports, transactions, and transaction totals.
- Review FBO and FBS returns.
- Read seller quality scores and rating history.
- List seller warehouses needed for stock updates.

## Limitations and notes

An Ozon Seller account and API credentials are required. The stated Admin API role is required for the complete tool set. API rate limits can affect request frequency, particularly for warehouse stock queries.

The license is listed as MIT plus Commons Clause. The Commons Clause restricts selling the software as a hosted service, with the repository license file providing the controlling terms.

_Full upstream README: https://allmcps.com/mcp/ozon-seller-mcp-server/readme_