Ozon Seller MCP Server

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

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

NPM package @woyax/mcp-ozon-seller

Claude Code

claude mcp add ozon-seller-mcp-server -e 'OZON_CLIENT_ID=<OZON_CLIENT_ID>' -e 'OZON_API_KEY=<your ozon_api_key>' -- npx -y @woyax/mcp-ozon-seller@1.0.0

Configuration JSON (Claude Desktop, Cursor, VS Code)

{
    "mcpServers": {
        "ozon-seller-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "@woyax/mcp-ozon-seller@1.0.0"
            ],
            "env": {
                "OZON_CLIENT_ID": "<OZON_CLIENT_ID>",
                "OZON_API_KEY": "<your ozon_api_key>"
            }
        }
    }
}

Variables d'environnement

OZON_CLIENT_ID obligatoire Ozon seller numeric ID. Find it in your Ozon Seller cabinet: Settings → API integrations → Seller API.
OZON_API_KEY obligatoire secret Ozon Seller API key (UUID). Generate it in your Ozon Seller cabinet: Settings → API integrations → Seller API. Recommended role: Admin.

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire

mcp-ozon-seller
Tools
Quick Start
n8n Integration
Example Prompts
Environment Variables
API Credentials
Rate Limits
Author & Support
Woyax AI Stack — Corporate AI Suite for Russian Business
License

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

Go to Ozon Seller
Settings → API Integrations → Seller API
Create new key with role Admin (required for all 26 tools)
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

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

Questions fréquentes

Qu'est-ce que Ozon Seller MCP Server ?

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

Comment installer Ozon Seller MCP Server ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add ozon-seller-mcp-server -e 'OZON_CLIENT_ID=<OZON_CLIENT_ID>' -e 'OZON_API_KEY=<your ozon_api_key>' -- npx -y @woyax/mcp-ozon-seller@1.0.0. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour Ozon Seller MCP Server ?

Oui. Il attend OZON_CLIENT_ID, OZON_API_KEY, à renseigner dans sa configuration.

Ozon Seller MCP Server est-il open source ?

Son code est public sur GitHub, mais le dépôt ne déclare pas de licence standard.

Qui maintient Ozon Seller MCP Server ?

Il est publié par woyaxnini. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.

Détails du serveur

Référencé dans: Registre MCP officiel
Éditeur: woyaxnini
Catégorie: Finance et paiements
Exécution: Local
Étoiles GitHub: ★ 7
Langage: TypeScript
Dernier commit: 17 avr. 2026
Tickets ouverts: 0
Version: 1.0.0
Publié le: 17 avr. 2026

io.github.woyaxnini/ozon-seller

Serveurs similaires

Backbone Manage your back office: invoices, reminders, receipts and time tracking in Germany and...
ARKOSCOPE Public Sources Read-only, dated public crypto source registry with evidence status. Local stdio; no AP...
Delegance Commercial Insurance Your company's commercial insurance: policies, coverage, certificates, quotes and claims.
Eclipse Beacon MCP The insurance watcher — signals your policies' expiries before they happen. It does not...
PuppyMacro Auto clicker, macros and hotkeys for PC. AI-ready. Needs the PuppyMacro app installed.
ZKStamp Proof-100 Shielded proof-of-existence timestamps on the BitcoinZ blockchain (zk-SNARKs).
TradeHub Perpetual futures trading for AI agents on the user's own exchange accounts, behind one...
Cuéntamo Household and freelance finances (Spain): balance forecast, spending, transactions, VAT...

Finance et paiements