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 fo

... [View full README on GitHub](https://github.com/woyaxnini/mcp-ozon-seller#readme)