Ozon Seller MCP Server

io.github.woyaxniniPublished by GitHub account woyaxniniv1.0.0Updated Oct 24, 2026

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

VerifiedSTDIODesktop onlyFinanceData & AnalyticsBusiness & Commerce

Overview

AI-generated overview

A local MCP server that connects an assistant to the Ozon Seller API so it can manage products, prices, stocks, orders, analytics and finances.

What you can do
Verify credentials and read seller account info, rating and rating history, plus warehouse lists and warehouse stock turnover data. List, read, create, update, archive and unarchive products, including bulk creation. Read and update prices and FBS warehouse stock levels. List and read FBO and FBS orders, including FBS orders awaiting shipment. Pull sales, revenue, views and returns analytics for any period. Read finance reports, transactions and transaction totals, and list FBO and FBS returns with reasons and amounts.
When to use it
Useful for Ozon marketplace sellers who want to query and adjust their store from an AI client such as Claude Desktop, Cursor or n8n, for example checking revenue, finding out-of-stock products, or changing a price.
Requirements
Runs locally over stdio via npx, so Node.js is needed, or can be self-hosted in HTTP mode with MCP_PORT. Requires an Ozon seller numeric ID in OZON_CLIENT_ID and an Ozon Seller API key in OZON_API_KEY, both generated in the Ozon Seller cabinet. Network access to the Ozon API.
Before you install
The API key is a full-access credential; the README recommends an Admin role key, so treat it as sensitive and keep it out of shared configs. Several tools write to the live store: creating, updating and archiving products, changing prices and stock levels. In HTTP mode credentials are passed in the request URL, which can leak into logs; the README suggests hosting it on your own VPS.

Installation

In SourceWeft

  1. Open Ozon Seller MCP Server in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

mcp-ozon-seller

[License: MIT + Commons Clause]

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

ToolDescription
get_seller_infoVerify credentials, get account info

B. Products

ToolDescription
list_productsList products with status filters
get_productProduct card: attributes, status, images
create_productCreate new products (up to 100 at once)
update_productUpdate product attributes and description
archive_productHide product from storefront
unarchive_productRestore product to active sale

C. Prices & Stocks

ToolDescription
get_pricesCurrent prices and price index
update_pricesUpdate prices (up to 1000 products at once)
get_stocksStock levels across all warehouses
update_stocksUpdate FBS warehouse stocks

D. Orders

ToolDescription
list_fbo_ordersList FBO orders
get_fbo_orderFBO order details
list_fbs_ordersList FBS orders
get_fbs_orderFBS order details
get_fbs_awaitingFBS orders waiting to be shipped

E. Analytics

ToolDescription
get_analyticsSales, revenue, views, returns — any period
get_warehouse_stocksOzon warehouse stocks with turnover data

F. Finance

ToolDescription
get_finance_reportCash flow report for a period
list_transactionsTransactions: accruals, commissions, payouts
get_transactions_totalsTransaction summary totals

G. Returns & Rating

ToolDescription
list_fbo_returnsFBO returns: items, reasons, amounts
list_fbs_returnsFBS returns: items, reasons, amounts
get_seller_ratingSeller quality index
get_seller_rating_historySeller rating history over time
list_warehousesSeller 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
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:

bash
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

VariableRequiredDescription
OZON_CLIENT_IDYesNumeric seller ID from Ozon personal account
OZON_API_KEYYesAPI key (UUID) from Ozon personal account
MCP_TRANSPORTNostdio (default) or http
MCP_PORTNoPort 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.

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.

ComponentWhat it doesLinks
mcp-max-messengerAI integration with MAX messenger: notifications, approvals, botsUse cases · Article
mcp-chestnyi-znakTrue API access for product labelling: marking codes, documents, balancesUse cases
mcp-ozon-sellerOzon store management: products, prices, orders, finance, analyticsGitHub
Woyax AI Process AuditorTelegram bot that conducts structured interviews with employees and builds a company AI automation mapArticle

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.

Source: README.md at commit 763e363

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.0.0LatestSep 16, 2026

Score

40% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.