Chiffrage d'un projet au meilleur prix livré, neuf et occasion, avec panier groupé optimisé
Three tools with complete input schemas and descriptions, but significant gaps in parameter documentation and output schema clarity. Tool names follow verb_noun convention (price_project, best_price, list_sources). Descriptions are present but lack actionable detail for LLM selection. Parameters have types but most lack individual descriptions. No output schema documentation. No error handling guidance. No tool annotations (readOnlyHint, etc.). Baseline: avg tool description ~120 chars (acceptable range 10-1024), but parameter descriptions are sparse or missing entirely.
Meilleur prix livré pour un seul article, neuf et occasion séparés.
État de chaque source : activée, quota horaire restant, coupure en cours.
Chiffre une liste d'articles au meilleur prix livré et rend le plan de commande groupé. C'est le point d'entrée principal : un seul appel pour tout le projet. Chaque article peut porter une quantité (« LD2410C x3 ») ou un plafond (« ESP32 <=12€ »). Rend le meilleur neuf et le meilleur occasion par article, le plan de commande qui minimise le total port compris, et l'écart avec le total naïf.
Parameter descriptions missing or minimal. 'detail' param in price_project/best_price lacks explanation of what 'compact' vs 'full' actually returns. 'radius_km' and 'used_threshold' lack context on units, valid ranges, or impact on results.
Output schema not documented. Tools return strings (rendered text), but LLMs cannot parse unstructured output reliably. No field definitions, no structured response format, no pagination guidance despite potentially large result sets.
No error handling guidance. Tools may fail (API quota, network, invalid article), but descriptions do not explain failure modes or recovery steps. LLM has no guidance on retry logic or fallback strategies.
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 49 | <=2025-11-25 | v2 |
Tool annotations missing. No readOnlyHint, destructiveHint, or idempotentHint declared. All three tools are read-only (safe to retry), but this is not signaled to the MCP client or agent.
best_price delegates to price_project with single-item array. This is composition via internal call, not a distinct tool. Consider whether best_price adds enough value or should be removed to reduce cognitive load on LLM tool selection.