Euro Pizza MCP server demonstrates solid fundamentals with well-structured tool definitions and clear descriptions. All 7 tools are explicitly registered via @mcp.tool() decorators with proper type annotations and parameter descriptions. Naming follows verb_noun convention (get_menu, search, add_to_basket, etc.). Descriptions are detailed (100-300 chars) and explain WHAT and WHEN. However, output schemas are not formally documented in the code, responses are JSON-serialized but the schema structure is inferred from code logic rather than declared. Input schemas are present via Annotated type hints but lack formal JSON Schema objects. Error handling returns JSON error objects but lacks recovery guidance. Tools properly separate concerns (menu browsing, searching, basket management) and are well-composed for agent chaining. No security concerns, session_id handling is reasonable (optional param with environment fallback), no secrets exposed as params, and all tools are read-only or reversible except add_to_basket (write) which is appropriately gated.

• Document output schemas for all tools. For europizza_menu, specify: { currency: string, categories: [{handle: string, name: string}], count: number, products: [{handle, name, category, description, picture, skus: [{name, handle, price_cents, available}]}] }. For basket tools, document item_key, product, handle, size, quantity, price_cents, options, total_cents fields.
• Add recovery guidance to error handling. When session_id is missing, return: 'error: "Pas de session LivePepper", recovery: "Set LIVEPEPPER_SESSION_ID environment variable or pass session_id parameter to tool". When product not found, return available_handles list as suggestions.
• Add pagination support to europizza_menu. Accept optional limit (default 20, max 100) and offset (default 0) parameters. Document: 'Returns up to 20 products per call to manage context. Use offset to browse next pages.' Return count and total_count fields so LLM knows when more results exist.
• Declare risk classifications as tool annotations. Add readOnlyHint=true to menu/search/view_basket tools. Add destructiveHint=true and idempotentHint=false to clear_basket. Add destructiveHint=true and idempotentHint=true to remove_from_basket. This enables LLM safety planning.
• Validate handle and sku parameters in add_to_basket/europizza_pizza. When a handle doesn't exist, return the error with a list of valid handles so the LLM can suggest alternatives ('Did you mean: margherita, napolitaine, ...?').
• Formalize category parameter in europizza_menu as an enum. Document: 'Optional filter by category. Valid values: pizzas, salades, snacking, desserts, boissons_softs, etc.' Extract actual enum from menu structure or hardcode if known.

Inferred effective spec: 2026-07-28+.

• Relies on Logging (deprecated) - log to stderr or use OpenTelemetry