Ozon Seller MCP Server

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

B. Products

C. Prices & Stocks

D. Orders

E. Analytics

F. Finance

G. Returns & Rating

---

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

---

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.

---

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.