Ozon Seller MCP Server

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

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Not yet automatically verified

We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "ozon-seller-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@woyax/mcp-ozon-seller"
      ]
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Capabilities & Tool Schemas (26)Self-reported

Inspect callable tools, capabilities, and parameters exposed to AI agents by Ozon Seller MCP Server.

get_seller_info

Verify credentials, get account info

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

Documentation Overview

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

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:

bash

MCP_PORT=3000 npx @woyax/mcp-ozon-seller --transport http

Connect from any MCP client:

Code

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:

Code

http://your-server.com:3000/mcp?client_id=CLIENT_ID&api_key=API_KEY

Example Prompts

Code

Show my revenue and orders for the last 7 days

Code

List all products that are out of stock

Code

Update the price for offer_id ABC-123 to 1990 rubles

Code

Show all FBS orders that are waiting to be shipped

Code

What's my current seller rating?

Code

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

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.

Read the full README →View source on GitHub →

Related MCP Servers

View all in Finance & Fintech View all alternatives

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars

Stargazers on the source repository.

Last commit

4mo ago

Most recent push to the default branch.

Tools exposed

Callable tools this server registers over MCP.

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Ozon Seller MCP Server

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "ozon-seller-mcp-server": { "command": "npx", "args": ["-y", "Ozon Seller MCP Server"] } }

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Ozon Seller MCP Server AllMCPs Directory Badge

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/ozon-seller-mcp-server?style=directory)](https://allmcps.com/mcp/ozon-seller-mcp-server)

HTML Embed

<a href="https://allmcps.com/mcp/ozon-seller-mcp-server"><img src="https://allmcps.com/api/badge/ozon-seller-mcp-server?style=directory" alt="Ozon Seller MCP Server on AllMCPs" /></a>

Technical Specs & Signals

CategoryFinance & Fintech

49Quality signal: Fair · 49/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools25/30

Adoption & activity2/15

Community engagement0/10

A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.

★ Spotlight Slot

Feature Your MCP Server

Get maximum visibility for your server across our directory, search results, and detail pages.

Spotlight Your Server

Own this project?

This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge and attach your website — proof is checked automatically, then reviewed by our team.

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💰 Finance & Fintech →Best MCP servers for Finance & Fintech →Alternatives to Ozon Seller MCP Server →Install in Claude Desktop Install in Cursor Install in VS Code

Ozon Seller MCP Server

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

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Not yet automatically verified

We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "ozon-seller-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@woyax/mcp-ozon-seller"
      ]
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Capabilities & Tool Schemas (26)Self-reported

Inspect callable tools, capabilities, and parameters exposed to AI agents by Ozon Seller MCP Server.

get_seller_info

Verify credentials, get account info

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

Documentation Overview

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

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:

bash

MCP_PORT=3000 npx @woyax/mcp-ozon-seller --transport http

Connect from any MCP client:

Code

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:

Code

http://your-server.com:3000/mcp?client_id=CLIENT_ID&api_key=API_KEY

Example Prompts

Code

Show my revenue and orders for the last 7 days

Code

List all products that are out of stock

Code

Update the price for offer_id ABC-123 to 1990 rubles

Code

Show all FBS orders that are waiting to be shipped

Code

What's my current seller rating?

Code

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.

Read the full README →View source on GitHub →

Related MCP Servers

View all in Finance & Fintech View all alternatives

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars

Stargazers on the source repository.

Last commit

4mo ago

Most recent push to the default branch.

Tools exposed

Callable tools this server registers over MCP.

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Ozon Seller MCP Server

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "ozon-seller-mcp-server": { "command": "npx", "args": ["-y", "Ozon Seller MCP Server"] } }

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/ozon-seller-mcp-server?style=directory)](https://allmcps.com/mcp/ozon-seller-mcp-server)

HTML Embed

<a href="https://allmcps.com/mcp/ozon-seller-mcp-server"><img src="https://allmcps.com/api/badge/ozon-seller-mcp-server?style=directory" alt="Ozon Seller MCP Server on AllMCPs" /></a>

Technical Specs & Signals

CategoryFinance & Fintech

49Quality signal: Fair · 49/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools25/30

Adoption & activity2/15

Community engagement0/10

★ Spotlight Slot

Feature Your MCP Server

Get maximum visibility for your server across our directory, search results, and detail pages.

Spotlight Your Server

Own this project?

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💰 Finance & Fintech →Best MCP servers for Finance & Fintech →Alternatives to Ozon Seller MCP Server →Install in Claude Desktop Install in Cursor Install in VS Code