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
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)

---

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.

• 📧 woyaxnini@gmail.com · woyax@yandex.com
• 💬 Telegram: @ale_oleg · Channel: @woyax_ai
• 💬 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
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.