MCP server providing tools to search and retrieve product information from Digikala, Iran's largest e-commerce platform
Six tools with consistent naming (verb_noun pattern: search_, product_, find_, get_) and basic descriptions. All tools are READ_ONLY and well-scoped. However, parameter descriptions are minimal (typically 1-2 phrases), output schemas are not documented in the source, and error handling guidance is absent. Tool definitions appear inferred from examples rather than explicitly registered in source code.
Find the best value product based on price and ratings
Get detailed information about a specific product
Get price history chart for a product
Get available variants for a product
Search for products on Digikala
Get available search filters for a category
Output schemas not documented. CardShape interface exists in docs/card.d.ts but is not formally declared in tool definitions. LLMs cannot plan downstream calls without knowing what fields to expect.
Parameter descriptions are minimal (1-2 phrases). 'Search query string' and 'Product ID' lack context on format, constraints, or when to use each tool vs. alternatives.
No error handling guidance. If a product ID is invalid or Digikala's CDN blocks the request, the tool returns isError=true but provides no recovery hint. LLMs cannot self-correct.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 58 | 2026-07-28+ | v2 |
Tool definitions inferred from examples (examples/python.py, scripts/verify-live.mjs) rather than explicitly visible in source. No explicit tool registration with schemas found in provided code.
No pagination or result-limiting guidance. search_digikala accepts 'limit' but no documentation on max allowed, default, or how to handle large result sets.