Read-only Shopify catalogue and stock MCP server. Standard library only - no MCP SDK, no GraphQL client.
Five read-only tools with consistent naming (verb_noun pattern: search_*, list_*, get_*) and complete input schemas. Descriptions are present and adequate (100-150 chars each), explaining what each tool does. However, output schemas are not documented in the source, the rubric requires explicit documentation of return types for A+ scoring. Parameter descriptions are minimal (10-30 chars) and lack detail on constraints, formats, or dependencies. No error handling guidance visible. Tools are well-composed (each does one thing) and follow the chat data model (accepting natural queries like 'threshold' rather than opaque IDs). Missing: output schema documentation, parameter constraint details, error recovery guidance.
Get detailed information about a product by its ID. Returns the product's title, handle, status, vendor, product type, total inventory, and online store URL.
List all variants of a product with their SKUs, titles, prices, and inventory quantities. Returns variant details including barcode, weight, and inventory tracking status.
Find all product variants with inventory below a specified threshold. Returns variants with their product titles, SKUs, prices, and current inventory quantities.
Search for products by title, handle, vendor, or product type. Returns matching products with their IDs, titles, handles, vendors, product types, total inventory, and online store URLs.
Search for product variants by SKU. Returns matching variants with their product titles, SKUs, prices, and current inventory quantities.
Output schemas not documented. Rubric requires explicit documentation of return types for all tools. Currently only input schemas are visible; return structure is inferred from descriptions.
Parameter descriptions lack constraint details. 'limit' parameters have no min/max bounds stated in descriptions (rubric baseline: 1 - 250 should be explicit). 'threshold' in low_stock has no guidance on valid range or units.
No error handling guidance. Tools lack descriptions of failure modes (e.g., invalid product_id format, API rate limits, network timeouts) and recovery steps. Rubric requires 'Error responses must tell the LLM what to do next.'
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 58 | <=2025-11-25 | v2 |
Pagination not explicitly documented. search_products and search_variants accept 'limit' but no mention of offset/cursor or total count in return. Rubric requires pagination guidance for list-returning tools.
Parameter descriptions are minimal (10 - 30 chars). Rubric baseline for A+ tools is 72 chars average. E.g., 'query' in search_products is 'Search query: product title, handle, vendor, or product type', good, but 'limit' is just 'Maximum number of results to return (default 10, max 250)' without explaining when to use it or what happens if omitted.