A zero-config MCP server for discovering Tokopedia — product search with full dynamic filtering, product detail, variants, rating summaries, promo campaigns, customer reviews, category browsing, and shop info. No login required.
Tokopedia-mcp has 9 well-named, read-only tools with consistent verb_noun naming (search_, get_, browse_). All tools have descriptions (avg ~80 chars, within baseline 34 - 392). Input schemas are present and typed. However, parameter descriptions are sparse or generic ('optional' without explaining what the parameter controls), output schemas are not documented, and error handling is absent. No tool annotations (readOnlyHint, etc.). The server is functional but lacks LLM-optimization depth expected of production tools.
Browse products in a Tokopedia category with recommendations and related categories
Get the complete Tokopedia category taxonomy with one level of children
Get available filters and sort options for a search query
Get detailed information about a specific product including variants, ratings, campaigns, and media
Get aggregated insights about a product including rating summary, campaigns, specs, breadcrumb, and media
Get customer reviews for a product with filtering and sorting options
Get all variant options and SKUs for a product with pricing and stock information
Get information about a Tokopedia shop including ratings, followers, and products
Parameter descriptions lack actionable constraints. E.g., 'orderBy' is described as 'Sort order (optional)' without explaining valid values, range, or what 'sort order' means numerically. LLMs cannot infer whether 0=ascending or 1=descending.
No output schemas documented. Tools return data but LLMs cannot plan downstream calls without knowing response structure. E.g., does search_products return product_id or id? Does it include shop_id for chaining to get_shop_info?
No error handling or recovery guidance. If a product URL is invalid or a shop ID not found, the tool likely returns a generic error. LLMs need actionable messages like 'Product not found. Try search_products() first.'
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 52 | 2026-07-28+ | v2 |
Search for products on Tokopedia with query and optional filters
No tool annotations. All tools are read-only (safe to retry), but readOnlyHint is not declared. Agents cannot distinguish safe tools from destructive ones without explicit hints.
Pagination parameters (page, rows, limit) lack documented bounds. LLMs may pass page=999999 or rows=10000, causing API strain or timeouts. Specify min/max in descriptions.