Loading ToolBench

Reading the current corpus…

ozon-shopping-mcp MCP server · C · ToolBench

← Browse

ozon-shopping-mcp

github.com/neosheps/ozon-shopping-mcp

Unofficial Ozon MCP server for buyer-side product search, prices, product cards, and reviews.

2025-06-18+STDIO5 tools

64/100

Definition Quality82

Protocol Readiness50

Supportability43

Spec posture

Inferred effective spec 2025-06-18+·current baseline 2026-07-28

Static source inference · medium confidence · evidence: structured output

No deprecated protocol patterns detected

Summary

Five tools with complete Zod schemas, clear descriptions (100-200 chars), and proper annotations. All parameters typed and described. Tool names follow verb_noun pattern (search, get, read, check, setup). Schemas include constraints (min/max, enums, defaults). Error handling via safeError() wrapper. Main gaps: no output schema documentation in code, no pagination for reviews/search results despite potentially large datasets, and missing recovery guidance in error messages.

Tools (5)

ozon_healthread onlysource verified80/100

Check whether a protected local browser session exists. Set live=true to also verify the session against Ozon.

ozon_productread onlysource verified83/100

Get current product data: prices, availability, seller, images, rating, review count, and key characteristics. A full product URL is preferred over a bare SKU.

ozon_reviewsread onlysource verified80/100

Read recent Ozon customer reviews for a product. A full product URL is preferred over a bare SKU.

ozon_searchread onlysource verified87/100

Search Ozon for products. Returns current session prices, ratings, review counts, images, and clean product URLs.

ozon_setup_sessionwritesource verified80/100

Open a temporary browser window, wait for Ozon to establish an anonymous session, save it locally, and close the window.

Issues (5)

HIGHtool ↗

Output schemas not documented in code. Tools return success()/failure() wrappers with structuredContent, but no schema definition visible for what fields agents should expect from search, product, or reviews responses.

ozon_searchozon_productozon_reviews

HIGHpaginated-result ↗

No pagination guidance for potentially large result sets. ozon_search and ozon_reviews accept limit parameters but no offset/cursor or total_count returned. Search results could exceed context window.

ozon_searchozon_reviews

MEDIUMrecovery-guide ↗

Error messages lack recovery guidance. safeError() wrapper returns generic error objects without actionable next steps. E.g., SESSION_REQUIRED error should suggest 'Call ozon_setup_session to establish a session.'

ozon_searchozon_productozon_reviewsozon_health

MEDIUM

Recommendations

Document output schemas for all tools. Add TypeScript interfaces or JSON Schema definitions showing what fields agents receive (e.g., product response includes: id, name, price, rating, seller, images, availability).
Add pagination support: include total_count in search/reviews responses and accept offset or cursor parameters. Cap default limit at 20-30 to prevent context window exhaustion.
Enhance error messages with recovery guidance. Wrap safeError() to detect SESSION_REQUIRED/SESSION_EXPIRED and append: 'Run ozon-shopping-mcp setup to establish a session.'
Clarify ozon_product 'product' parameter format in description: 'Accepts full Ozon URL (https://ozon.ru/product/...), numeric SKU, or product slug. URL is preferred for accuracy.'
Add optional dry_run parameter to ozon_setup_session or document that it opens a temporary browser window and closes it automatically, reducing user surprise.

Score history

Overall score trend

First recorded score · v2 rubric

64/100

Scored	Grade	Overall	Spec posture	Rubric
2026-09-23	C	64	2025-06-18+	v2