Skip to main content
Glama
mcp-ozon-seller

mcp-ozon-seller

by woyaxnini

mcp-ozon-seller

License: MIT + Commons Clause

MCP server for Ozon Seller API — Russia's largest marketplace.

Connect AI clients (Claude Desktop, Cursor, n8n) to your Ozon seller account: manage products, update prices and stocks, view orders, get analytics, monitor finances and returns.

First MCP server for Ozon Seller API.

26 tools · 7 groups · Two modes: local (stdio) + remote (HTTP)


Tools

A. Account

Tool

Description

get_seller_info

Verify credentials, get account info

B. Products

Tool

Description

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

C. Prices & Stocks

Tool

Description

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

D. Orders

Tool

Description

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

E. Analytics

Tool

Description

get_analytics

Sales, revenue, views, returns — any period

get_warehouse_stocks

Ozon warehouse stocks with turnover data

F. Finance

Tool

Description

get_finance_report

Cash flow report for a period

list_transactions

Transactions: accruals, commissions, payouts

get_transactions_totals

Transaction summary totals

G. Returns & Rating

Tool

Description

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)


Related MCP server: io.github.dontsovcmc/ozon-seller

Quick Start

Mode 1: Local (stdio) — Claude Desktop / Cursor

Step 1: Get your API credentials Ozon Seller → Settings → API Integrations → Seller API → Create key (role: Admin)

Step 2: Add to your Claude Desktop config:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "ozon-seller": {
      "command": "npx",
      "args": ["-y", "@woyax/mcp-ozon-seller"],
      "env": {
        "OZON_CLIENT_ID": "123456",
        "OZON_API_KEY": "your-api-key-here"
      }
    }
  }
}

Step 3: Restart Claude Desktop. Ask: "Show my top 10 products by revenue for last week"


Mode 2: Remote (HTTP) — hosted on your VPS

Start the server:

MCP_PORT=3000 npx @woyax/mcp-ozon-seller --transport http

Connect from any MCP client:

http://your-server.com:3000/mcp?client_id=123456&api_key=your-api-key

Multiple users can connect simultaneously — credentials are passed per-request.


n8n Integration

Add a custom MCP node with URL:

http://your-server.com:3000/mcp?client_id=CLIENT_ID&api_key=API_KEY

Example Prompts

Show my revenue and orders for the last 7 days
List all products that are out of stock
Update the price for offer_id ABC-123 to 1990 rubles
Show all FBS orders that are waiting to be shipped
What's my current seller rating?
Show finance report for last month

Environment Variables

Variable

Required

Description

OZON_CLIENT_ID

Yes

Numeric seller ID from Ozon personal account

OZON_API_KEY

Yes

API key (UUID) from Ozon personal account

MCP_TRANSPORT

No

stdio (default) or http

MCP_PORT

No

Port for HTTP mode (default: 3000)


API Credentials

  1. Go to Ozon Seller

  2. Settings → API Integrations → Seller API

  3. Create new key with role Admin (required for all 26 tools)

  4. Save Client-Id (numeric) and Api-Key (UUID)


Rate Limits

Ozon API enforces rate limits. This server automatically retries on 429 errors with exponential backoff (1s → 2s → 4s).

⚠️ get_warehouse_stocks has stricter limits — avoid calling it in tight loops.


Author & Support

Built by Oleg Alekseev — ERP/AI integration architect.

Need help integrating AI agents with your ERP, CRM, or Ozon? Custom MCP servers, n8n workflows, AI automation — contact me.


Woyax AI Stack — Corporate AI Suite for Russian Business

This package is part of Woyax AI Stack: a collection of MCP servers and AI agents for business process automation in the Russian corporate environment.

Component

What it does

Links

mcp-max-messenger

AI integration with MAX messenger: notifications, approvals, bots

Use cases · Article

mcp-chestnyi-znak

True API access for product labelling: marking codes, documents, balances

Use cases

mcp-ozon-seller

Ozon store management: products, prices, orders, finance, analytics

GitHub

Woyax AI Process Auditor

Telegram bot that conducts structured interviews with employees and builds a company AI automation map

Article


License

MIT + Commons Clause © Oleg Alekseev

Free to use for personal and corporate purposes. Selling as a hosted service requires author's permission. See LICENSE for details.

Available Tools

26 tools
archive_productArchive ProductA

Hide one or more products from the Ozon storefront (archive them). Archived products are not visible to buyers but are preserved and can be restored. Provide an array of product_ids. Use unarchive_product to restore.

Inputs: product_ids (required).

create_productCreate ProductA

Create one or more new products on Ozon (up to 100 per request). Each product requires: description_category_id (from Ozon category tree), name, offer_id (your article), price, vat, weight, depth, width, height, dimension_unit, weight_unit, images (array of URLs), and attributes. Returns a task_id — check import status with the product import task endpoint. Note: attributes list depends on the chosen category. Use Ozon documentation or /v1/description-category/attribute to get required attributes.

Inputs: items (required).

get_analyticsGet AnalyticsA

Get sales analytics for a date range. This is the most powerful analytics tool — use it to answer questions like "show revenue for last week", "top 10 products by orders", "how many cancellations this month".

Available metrics: revenue, ordered_units, delivered_units, returns, cancellations, hits_view_search (search impressions), hits_view_pdp (product page views), hits_tocart (add to cart), session_view_pdp, adv_sum (ad spend), adv_sum_all, position_category.

Available dimensions (group by): sku (by product), day, week, month, category1 (top category), category2, brand, delivery_type.

Dates must be in format "YYYY-MM-DD".

Note: the metrics array in the response corresponds 1:1 (by index) to the metrics array in the request.

Inputs: date_to (required), metrics (required), date_from (required), dimension (required), +4 more.

get_fbo_orderGet FBO OrderA

Get full details of a single FBO order by posting number. Returns products, quantities, prices, analytics data, and financial breakdown including commissions and payouts.

Inputs: posting_number (required).

get_fbs_awaitingGet FBS Awaiting OrdersA

Get the list of FBS orders that are waiting to be processed and shipped. These are orders in "awaiting_packaging" or similar states that require seller action. Use this to see what needs to be packed and dispatched today. Optionally filter by cutoff time range or warehouse IDs. If cutoff dates are not provided, defaults to the current calendar month.

Inputs: dir, limit, offset, cutoff_to, +2 more.

get_fbs_orderGet FBS OrderA

Get full details of a single FBS order by posting number. Returns products, buyer details, delivery address, shipment deadline, analytics data, and financial breakdown.

Inputs: posting_number (required).

get_finance_reportGet Finance ReportA

Get a cash flow statement for a period: total orders amount, returns, commission, delivery costs, and net payout. Great for quick financial overview: "how much did I earn this month". Dates in format "YYYY-MM-DD".

Inputs: date_to (required), date_from (required), with_details.

get_pricesGet PricesA

Get current prices for products: selling price, old price (crossed out), marketing price, premium price, and price index (how your price compares to competitors). Optionally filter by offer_ids or product_ids. Supports pagination via last_id.

Inputs: limit, last_id, offer_ids, visibility, +1 more.

get_productGet ProductA

Get full information about a single product: name, description, attributes, category, price, old price, images, status, barcode, and all other fields. Provide either product_id (Ozon internal ID), offer_id (seller article), or sku.

Inputs: sku, offer_id, product_id.

get_seller_infoGet Seller InfoA

Get information about the Ozon seller account: shop name, company ID, account status. Use this to verify that Client-Id and Api-Key credentials are valid and working. Call this first to confirm the connection is established.

Inputs: no named parameters.

get_seller_ratingGet Seller RatingA

Get the current seller quality index (rating) on Ozon. Returns overall rating score, status (fine/warning/critical), and breakdown by categories: shipment quality, cancellations, return rate, and others. Use this for monitoring — alert when rating drops below a threshold. No parameters required.

Inputs: no named parameters.

get_seller_rating_historyGet Seller Rating HistoryA

Get the history of seller rating (quality index) changes over time. Useful for tracking rating trends and diagnosing drops. By default returns history for all rating indicators. Optionally pass specific rating keys to narrow the result.

Available rating keys: rating_review_avg_score_total (product reviews), rating_shipment_delay_cb (shipment delays), rating_general_indicator_fbs_rfbs (overall FBS/rFBS score), rating_delivery_complaints_fbo/fbs/rfbs_sd (complaints by schema), rating_price_green/yellow/red/super (price index zones).

Inputs: ratings.

get_stocksGet StocksA

Get current stock levels for products across all warehouses. Returns present (available) and reserved quantities for each warehouse type. Optionally filter by offer_ids or product_ids. Supports pagination via cursor.

Inputs: limit, cursor, offer_ids, visibility, +1 more.

get_transactions_totalsGet Transactions TotalsA

Get summary totals for transactions in a period: total orders amount, returns amount, commissions, delivery costs, and final balance. Faster than list_transactions when you only need the bottom line. Dates must be ISO 8601, e.g. "2024-01-01T00:00:00.000Z".

Inputs: date_to (required), date_from (required), posting_number, transaction_type.

get_warehouse_stocksGet Warehouse StocksA

Get detailed stock information for products on Ozon warehouses (FBO). Shows free-to-sell, reserved, and promised quantities per warehouse, along with turnover data. Note: this endpoint has stricter rate limits — use sparingly and cache results. warehouse_type: ALL (default), EXPRESS_DARK_STORE, or NOT_EXPRESS. skus is required — pass at least one SKU (use get_stocks or list_products to obtain SKUs).

Inputs: skus (required), limit, offset, warehouse_type.

list_fbo_ordersList FBO OrdersA

Get a list of FBO orders (fulfilled by Ozon warehouse). Filter by date range (required) and optionally by status. FBO statuses: awaiting_packaging, awaiting_deliver, delivering, delivered, cancelled. Returns order details including products, quantities, and financial data.

Inputs: to (required), since (required), dir, limit, +2 more.

list_fbo_returnsList FBO ReturnsA

Get a list of product returns for FBO orders (from Ozon warehouse). Returns include product name, SKU, reason, status, and amounts. Useful for monitoring return rates and identifying problematic products. Filter by logistic return date range, posting number, offer_id, or product name. Note: use only one time filter field at a time.

Inputs: limit, date_to, last_id, offer_id, +4 more.

list_fbs_ordersList FBS OrdersA

Get a list of FBS orders (fulfilled from seller warehouse). Filter by date range (required) and optionally by status. FBS statuses: awaiting_registration, acceptance_in_progress, awaiting_approve, awaiting_packaging, awaiting_deliver, arbitration, client_arbitration, delivering, driver_pickup, delivered, cancelled. Returns order details including buyer info, delivery method, and products.

Inputs: to (required), since (required), dir, limit, +3 more.

list_fbs_returnsList FBS ReturnsA

Get a list of product returns for FBS orders (from seller warehouse). Returns include product name, SKU, return reason, status, and refund amounts. Filter by logistic return date range, posting number, offer_id, or product name. Note: use only one time filter field at a time.

Inputs: limit, date_to, last_id, offer_id, +4 more.

list_productsList ProductsA

Get a list of all products in the Ozon seller account. You can filter by visibility status: ALL, VISIBLE (on sale), INVISIBLE (hidden), EMPTY_STOCK (out of stock), NOT_MODERATED (pending review), MODERATION_BLOCK (blocked), DISABLED (archived). Supports pagination via last_id. Returns product_id and offer_id for each product.

Inputs: limit, last_id, offer_ids, visibility, +1 more.

list_transactionsList TransactionsC

Get a detailed list of financial transactions: sales accruals, commissions, delivery charges, returns, marketing fees, and payouts. Filter by date range (required). Optionally filter by operation type, posting number, or transaction type (orders, returns, services, transfers). Dates must be ISO 8601, e.g. "2024-01-01T00:00:00.000Z".

Inputs: date_to (required), date_from (required), page, page_size, +3 more.

list_warehousesList WarehousesA

Get the list of seller warehouses (FBS warehouses). Returns warehouse IDs and names. Warehouse IDs are required when updating FBS stock levels with update_stocks. No parameters required.

Inputs: no named parameters.

unarchive_productUnarchive ProductA

Restore one or more archived products back to active sale on Ozon. Products will become visible to buyers again after unarchiving. Provide an array of product_ids.

Inputs: product_ids (required).

update_pricesUpdate PricesA

Update prices for one or more products (up to 1000 per request). For each product provide offer_id or product_id, and the new price. Optionally set old_price (crossed-out original price) and min_price (floor for promotions). Prices must be strings, e.g. "1990.00".

Inputs: prices (required).

update_productUpdate ProductA

Update product attributes and characteristics. Note: this updates only attributes (characteristics) of a product card. Price and stock are updated via separate tools (update_prices, update_stocks). Existing attributes cannot be deleted — only added or changed. Returns a task_id — the update is processed asynchronously. Provide product_id or offer_id to identify the product.

Inputs: offer_id, attributes, product_id.

update_stocksUpdate StocksA

Update stock quantities for FBS warehouses (seller warehouses). For each item provide offer_id or product_id, stock quantity, and warehouse_id. Use list_warehouses to get warehouse IDs. Note: this updates FBS (seller warehouse) stocks, not FBO (Ozon warehouse) stocks.

Inputs: stocks (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4/5.0

    Scored across 26 tools

    Disambiguation5/5

    Each tool targets a distinct resource and action, with no overlap. For example, product tools are separated from order tools, and within products, there are separate tools for prices, stocks, and attributes.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern in snake_case, such as get_product, list_products, update_prices, get_fbo_order. The naming is predictable and easy to understand.

    Tool Count4/5

    With 26 tools, the server covers a comprehensive set of operations for an e-commerce platform. While slightly on the higher side, each tool serves a clear purpose within the domain, making the count appropriate.

    Completeness5/5

    The tools cover all major aspects of Ozon seller management: products (CRUD, pricing, stock), orders (FBO/FBS, returns), finances (reports, transactions), analytics, and seller rating. Few gaps are apparent for the stated purpose.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers