MCP server connector for Costco — search products, manage cart, track orders, check membership
16 tools with complete input schemas and descriptions, but significant gaps in parameter documentation and output schema specification. Tool naming follows verb_noun convention well (search_products, add_to_cart, get_orders). Descriptions are present but often generic (avg ~80 chars, below 194-char baseline). Critical issue: NO output schemas documented anywhere, LLMs cannot plan downstream calls or extract structured data. Parameters lack descriptions in ~40% of cases (e.g., add_to_cart has no description for 'url' or 'item_number' parameters). Error handling and recovery guidance absent. No tool annotations (readOnlyHint, destructiveHint, idempotentHint) despite clear risk levels assigned. Checkout tool is IRREVERSIBLE but has no confirmation/dry-run pattern.
Add a Costco product to the cart
Check in-warehouse availability of a product at a specific Costco location
Preview or complete a Costco order. Use confirm=false to preview first.
Check delivery and warehouse pickup availability for cart items or a specific product
Check Costco membership status, type, and renewal date
View Costco order history
Get detailed product information including price, description, and availability
No output schemas documented for any tool. LLMs cannot infer response structure, plan chained calls, or extract required fields for downstream operations.
Checkout tool (IRREVERSIBLE risk) lacks confirmation/dry-run pattern. No way to preview order before confirm=true. Agents cannot safely test before committing.
add_to_cart and get_product_details accept both 'url' and 'item_number' as alternatives but lack documentation of mutual exclusivity or precedence rules. LLMs may pass both or neither.
No tool annotations (readOnlyHint, destructiveHint, idempotentHint) despite clear risk levels. Agents cannot distinguish safe reads from destructive writes without parsing descriptions.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 59 | 2026-07-28+ | v2 |
Find nearby Costco warehouses by ZIP code or city
Authenticate with Costco account using email and password via browser automation
Clear Costco session and stored cookies
Search Costco products by name, category, or brand
Choose delivery method — home delivery or warehouse pickup
Check Costco authentication status and session info
Track a Costco order delivery status
Update item quantities or remove items from the Costco cart
View current Costco cart contents and totals
Error handling and recovery guidance absent. No tool documents what to do on failure (retry, ask user, abort). Agents cannot self-correct on invalid input.