MCPHIVE

Ozon MCP: Documentation

Updated:

Connection

Source only: git clone https://github.com/PCDCK/ozon-mcp, uv sync, run uv run ozon-mcp (stdio; needs Python 3.12+ and uv). ⚠️ The identically-named ozon-mcp package on PyPI is a different, unrelated project (Ozon browser automation) — don't install via pip install ozon-mcp.

Auth: OZON_CLIENT_ID + OZON_API_KEY from seller.ozon.ru → Settings → API keys; for ads, additionally OZON_PERFORMANCE_CLIENT_ID + OZON_PERFORMANCE_CLIENT_SECRET.

Capabilities

15 meta-tools instead of one command per action — access to a catalog of 466 methods (420 Seller + 46 Performance, 55 sections):

  • ozon_call_method / ozon_fetch_all — call a method / auto-walk every cursor page.
  • ozon_search_methods / ozon_describe_method / ozon_get_examples — find a method and get its schema with an example.
  • ozon_list_sections / ozon_get_section / ozon_get_related_methods — browse the API by section.
  • ozon_list_workflows / ozon_get_workflow — 13 ready-made scenarios (oos_risk_analysis, pricing_analysis, content_audit, cabinet_health_check, etc.) with a step-by-step plan and common mistakes.
  • ozon_get_subscription_status / ozon_list_methods_for_subscription — check your cabinet's tier before calling a gated method.
  • ozon_get_rate_limits / ozon_get_swagger_meta / ozon_get_error_catalog — limits, spec freshness, error lookups.

Agent flow

"Run oos_risk_analysis — which products risk going out of stock?", "fetch all products via ozon_fetch_all and compare to last week", "check cabinet_health_check — what's wrong with my seller rating?".

Limits

43 destructive methods are double-gated; calling a method your tier doesn't unlock is blocked before the request is sent. Development is uneven — the last commit was in April 2026.

Note

A community project, not an official Ozon product. Alternative implementations exist (woyaxnini, Oxonomy) with a different tool set.

Ozon MCP — Documentation