Three tools with explicit schemas and descriptions, but significant quality gaps. Tool names lack clear action verbs (product_list vs list_products, product_delete_translation vs delete_product_translation). Descriptions are present but generic and lack actionable context. Parameter descriptions are minimal. No output schemas documented. Error handling is basic. The server exposes GraphQL implementation details rather than abstracting to a clean agent interface.
Call this event to create a glossary for translation. If there is a source text in a given language, the translation will be updated.
Call this action to delete a product translation.
Returns information about the total number of products in pageInfo, ie. Due to the number you can use First: 1.
Tool names do not start with clear action verbs. 'product_list' should be 'list_products'; 'product_delete_translation' should be 'delete_product_translation'. LLMs infer intent from the verb, weak naming increases selection errors.
No output schemas documented. Callers cannot predict response structure. The code returns createResponse() with {content, isError} but LLMs have no way to know this without reading source. Document what each tool returns.
Descriptions are generic and lack context. 'Returns information about the total number of products in pageInfo' is vague, what is pageInfo? When should this be called? What does it return? Descriptions should be 50 - 200 chars and answer WHAT, WHEN, and WHAT-RETURNS.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 43 | 2026-07-28+ | v2 |
Parameter descriptions are minimal. 'Count product to page' is unclear, is this a limit? A page number? The 'identifier' param says 'Filter by client ID (e.g. ABC-123, 1456)' but includes example values, which LLMs may reuse literally. Use enums or patterns instead.
Destructive tool (product_delete_translation) has no confirmation or dry-run option. Agents can permanently delete translations without a safety gate. Implement a confirm_before_execute pattern or require explicit confirmation.