Ozon Seller MCP Server

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

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

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

JSON configuration (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>"
            }
        }
    }
}

Environment variables

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

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents

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.

Frequently asked questions

What is Ozon Seller MCP Server?

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

How do I install Ozon Seller MCP Server?

It runs on your machine. In 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. For other clients, paste the JSON configuration from this page into their MCP settings.

Does Ozon Seller MCP Server need an API key?

Yes. It expects OZON_CLIENT_ID, OZON_API_KEY, which you set in its configuration.

Is Ozon Seller MCP Server open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains Ozon Seller MCP Server?

It is published by woyaxnini. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.

Server details

Listed in: Official MCP Registry
Publisher: woyaxnini
Category: Finance and payments
Runs: Local
GitHub stars: ★ 7
Language: TypeScript
Last commit: Apr 17, 2026
Open issues: 0
Version: 1.0.0
Published: Apr 17, 2026

io.github.woyaxnini/ozon-seller

Similar servers

FuelTaxMath Official IFTA fuel tax rates plus IFTA, cost per mile, load profit and Form 2290 HVUT c...
Eclipse Scamshield First-payment witnessed risk briefing over fixture sources with receipted acknowledgment.
bank-mcp Unofficial read-only MCP server for UK bank and card data via TrueLayer Open Banking
Daftra Connector (Awsel) Turn chat invoices into drafts in Daftra accounting. 16 tools, OAuth sign-in, human app...
Wafeq Connector (Awsel) Turn chat invoices into drafts in Wafeq accounting. 17 tools, OAuth sign-in, human appr...
Qoyod Connector (Awsel) Turn chat invoices into drafts in Qoyod accounting. 27 tools, OAuth sign-in, human appr...
Keyban Agent Wallet Give an AI agent its own blockchain wallet: balances, USDC transfers, x402 payments und...
Borro Stock lending on Robinhood Chain: read markets and prepare lends, loans, shorts and cre...

Finance and payments