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)
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.
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.
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.