mcp-ozon-seller
Enables n8n workflows to interact with Ozon Seller API for automating product management, order processing, and financial reporting.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mcp-ozon-seller List all products that are out of stock"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
mcp-ozon-seller
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 |
| Verify credentials, get account info |
B. Products
Tool | Description |
| List products with status filters |
| Product card: attributes, status, images |
| Create new products (up to 100 at once) |
| Update product attributes and description |
| Hide product from storefront |
| Restore product to active sale |
C. Prices & Stocks
Tool | Description |
| Current prices and price index |
| Update prices (up to 1000 products at once) |
| Stock levels across all warehouses |
| Update FBS warehouse stocks |
D. Orders
Tool | Description |
| List FBO orders |
| FBO order details |
| List FBS orders |
| FBS order details |
| FBS orders waiting to be shipped |
E. Analytics
Tool | Description |
| Sales, revenue, views, returns — any period |
| Ozon warehouse stocks with turnover data |
F. Finance
Tool | Description |
| Cash flow report for a period |
| Transactions: accruals, commissions, payouts |
| Transaction summary totals |
G. Returns & Rating
Tool | Description |
| FBO returns: items, reasons, amounts |
| FBS returns: items, reasons, amounts |
| Seller quality index |
| Seller rating history over time |
| 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.jsonWindows:
%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 httpConnect from any MCP client:
http://your-server.com:3000/mcp?client_id=123456&api_key=your-api-keyMultiple 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_KEYExample Prompts
Show my revenue and orders for the last 7 daysList all products that are out of stockUpdate the price for offer_id ABC-123 to 1990 rublesShow all FBS orders that are waiting to be shippedWhat's my current seller rating?Show finance report for last monthEnvironment Variables
Variable | Required | Description |
| Yes | Numeric seller ID from Ozon personal account |
| Yes | API key (UUID) from Ozon personal account |
| No |
|
| No | Port for HTTP mode (default: |
API Credentials
Go to Ozon Seller
Settings → API Integrations → Seller API
Create new key with role Admin (required for all 26 tools)
Save
Client-Id(numeric) andApi-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.
💬 MAX: max.ru/id503610654564_biz
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 |
AI integration with MAX messenger: notifications, approvals, bots | ||
True API access for product labelling: marking codes, documents, balances | ||
Ozon store management: products, prices, orders, finance, analytics | ||
Telegram bot that conducts structured interviews with employees and builds a company AI automation map |
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 toolsarchive_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
Scored across 26 tools
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.
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.
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.
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
Related MCP Connectors
Hosted MCP server for OTTO Market, Kaufland and Mirakl sellers: orders, stock, listings and ads.
Hosted Amazon Seller and Vendor MCP server for Claude, ChatGPT, Cursor, Codex, Gemini, Copilot.
Hosted Amazon Seller Central and Amazon Ads MCP server for Claude, ChatGPT, Cursor, and agents.
Unified MCP server for 70+ eCommerce platforms: products, orders, customers, and more.
Related MCP Servers
- AlicenseAqualityCmaintenanceMCP server for Ozon marketplace that enables AI assistants to search products, get detailed information, prices, and delivery info from Ozon.ru.327 npm89MIT
- AlicenseAqualityDmaintenanceMCP server for Ozon Seller API, enabling product, order, finance, and analytics management via natural language or CLI.32MIT
- AlicenseAqualityDmaintenanceMCP server for Wildberries Seller API enabling management of products, orders, supplies, analytics, advertising, and finance through natural language commands.32MIT
- AlicenseNot gradedqualityBmaintenanceMCP server for Ozon sellers with a built-in Chinese operations knowledge base and 466 API methods, enabling AI agents to discover, understand, and execute Ozon Seller and Performance API operations safely and efficiently.1MIT