A collection of MCP server implementations demonstrating various patterns and tools for e-commerce analytics, order management, inventory, and customer data.
Workshop-MCP exhibits moderate definition quality with inconsistent naming, descriptions of varying quality, and schemas present but incomplete. Tool names follow verb-noun convention (analyze_, get_, search_, check_, query_) which is good, but descriptions are verbose and include problematic example values. Schemas are defined inline in GetDefinition() methods but lack comprehensive output schema documentation. 11 tools total, with significant variability in parameter clarity and description precision. The server is multilingual (Spanish) which adds complexity but is not inherently a problem. Average tool score across all 11: 58. Key gaps: output schemas undocumented, parameter descriptions sometimes vague, error handling guidance missing, examples embedded in descriptions rather than using enums/patterns.
Analizar el comportamiento de un usuario específico
Calcula métricas de negocio: total de ventas, promedio de pedido, productos más vendidos
Verifica el inventario disponible de un producto específico. IMPORTANTE: Esta herramienta requiere el parámetro 'productId' (number, requerido) que es el ID numérico del producto (ejemplo: 101, 102, 105). NO uses nombres de productos, solo IDs numéricos. Usa esta herramienta cuando te pregunten sobre disponibilidad, stock, o inventario de un producto específico.
Obtiene carritos abandonados en las últimas N horas. IMPORTANTE: Esta herramienta requiere el parámetro 'hours' (number, opcional, por defecto 24). Usa esta herramienta cuando te pregunten sobre carritos abandonados o usuarios que no completaron sus compras.
Obtiene información detallada de un pedido específico, incluyendo cliente, producto, cantidad y monto total. IMPORTANTE: Esta herramienta requiere el parámetro 'orderId' (integer). Usa esta herramienta cuando te pregunten sobre un pedido específico por su número o ID (ejemplo: 'pedido 1001', 'pedido número 1001', 'order 1001').
Tool definitions are duplicated: get_order_details appears in both Exercise2Server and RestApiMcpServer (tools #4 and #9). This violates composition principle and forces LLMs to disambiguate identical-named tools. Should consolidate into one canonical tool or rename variants (e.g., get_order_details_v2, get_ecommerce_order_details).
Descriptions contain embedded example values that LLMs may reuse literally. E.g., 'IMPORTANTE: Esta herramienta requiere el parámetro "productId" (number, requerido) que es el ID numérico del producto (ejemplo: 101, 102, 105)', LLMs frequently pass the exact examples (101, 102, 105) in real calls instead of context-appropriate values. Replace examples with enum constraints or regex patterns.
No output schemas documented. The GetDefinition() methods show inputSchema but do not expose outputSchema or describe what fields the tool returns. LLMs cannot plan downstream tool calls or extract chaining IDs without knowing output structure. All 11 tools lack formal output documentation.
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-22 | D | 52 | <=2025-11-25 | v2 |
| 2026-03-09 | F | 47 | - | v1 |
Obtiene detalles completos de un pedido incluyendo cliente y producto
Calcula estadísticas agregadas de ventas: total de pedidos, ventas totales, ticket promedio, productos más vendidos. Usa esta herramienta para preguntas sobre métricas generales de ventas (ejemplo: 'estadísticas de ventas', 'total de ventas', 'productos más vendidos').
Obtiene el estado de envío y tracking de un pedido específico. IMPORTANTE: Esta herramienta requiere el parámetro 'orderId' (number, requerido) que es el ID numérico del pedido (ejemplo: 1001, 1002). Usa esta herramienta cuando te pregunten sobre el estado de envío, tracking, entrega o dónde está un pedido.
Obtiene el ranking de productos más vendidos con estadísticas de ventas e ingresos. IMPORTANTE: Parámetros opcionales 'limit' (number, por defecto 10) para número de productos a mostrar y 'period' (string: 'day'/'week'/'month', por defecto 'week') para el período de análisis. Usa esta herramienta cuando te pregunten sobre productos más vendidos, top productos, mejores productos, ranking de ventas, o productos populares.
Busca y lista clientes registrados en un país específico, con opción de filtrar por ciudad. Usa esta herramienta cuando te pregunten cuántos clientes hay en un país o ciudad (ejemplo: '¿Cuántos clientes hay en España?', '¿Clientes en Madrid?').
Busca clientes por nombre parcial y/o país
Error handling guidance is absent. The Execute() methods validate parameters (e.g., userId required in analyze_user_behavior) but error responses are generic ArgumentExceptions. No recovery guidance is provided to LLMs (e.g., 'User not found. Try search_customers()' or 'Invalid productId, must be an integer 1-9999').
Descriptions are verbose (many exceed 200 chars) and mix multiple concerns. E.g., get_abandoned_carts description is 265 chars and includes 'IMPORTANTE' header, default value explanation, and usage guidance all at once. Should split: short summary (under 100 chars), then parameter descriptions carry the nuance.
Parameter descriptions for search_customers are incomplete. 'name' and 'country' have descriptions but no constraints are specified. Is name case-insensitive? What's the minimum length? What happens if both are omitted? The description says 'required': [] but does not explain the implications (e.g., 'Both optional, omit to list all customers').
No idempotency guarantees or operation classification. Tools like get_order_details, check_inventory are clearly read-only (risk: READ_ONLY is noted), but the descriptions do not state 'This tool is read-only and safe to retry.' Write operations (if any exist in other servers) should declare 'This creates a new resource' vs 'This updates an existing resource' vs 'This is irreversible.'
Multilingual descriptions (all in Spanish) may limit discoverability and LLM compatibility for non-Spanish-trained models. Consider providing both Spanish and English descriptions, or document the language assumption. Tool names remain English (analyze_user_behavior, get_abandoned_carts) which is correct, but descriptions being Spanish-only could cause LLM confusion.