MCP server for e-commerce data: product search, barcode lookup, cart management, category browsing
Server has 8 tools with basic schemas and descriptions in German. All tools have input schemas with type definitions and descriptions present. However, descriptions are minimal (10-80 chars, well below the 50-200 char LLM-optimized baseline), lack context on WHEN to use tools, and omit recovery guidance. Parameter descriptions are present but terse. Output schemas are not documented. Error handling returns generic error strings without actionable recovery steps. No tool annotations (readOnlyHint/destructiveHint). manage_cart and manage_wishlist combine multiple actions (add/remove/view) in single tools, violating single-responsibility principle. No pagination support despite search_products and get_products_by_category returning lists. Naming is verb-first and clear, but parameter naming could be more explicit (e.g., 'action' enum values should be constrained).
Details zu einem bestimmten Produkt abrufen.
Produkte einer Kategorie abrufen.
Zusammenfassung von Warenkorb und Wunschliste abrufen.
Alle verfuegbaren Produktkategorien auflisten.
Produkt per UPC/EAN-Barcode nachschlagen (UPCitemdb, kostenlos).
Einkaufswagen verwalten (hinzufuegen, entfernen, anzeigen, leeren).
Wunschliste verwalten (hinzufuegen, entfernen, anzeigen).
Descriptions are too short (10-80 chars vs. 50-200 char baseline). Lack context on WHEN to use each tool and prerequisites. LLMs cannot reliably select tools without richer descriptions.
manage_cart and manage_wishlist combine multiple actions (add/remove/view/clear) in single tools. Violates single-responsibility principle. Should split into separate tools: add_to_cart, remove_from_cart, view_cart, clear_cart.
No output schemas documented. LLMs cannot plan downstream calls or extract fields reliably. get_product_details returns 15+ fields but no schema specification visible.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 46 | 2026-07-28+ | v2 |
Produkte nach Suchbegriff durchsuchen.
Error handling returns generic error strings ('error': str(e)) without actionable recovery guidance. No categorization of retryable vs. fatal errors. LLMs cannot self-correct.
No pagination support for list-returning tools. search_products and get_products_by_category accept 'limit' but no offset/page/cursor. Large result sets will blow context window.