¡Hola developer 👋🏻! En este repo encontrarás un ejemplo de cómo funciona las elicitations en Model Context Protocol.
Single tool 'search-videos' with Spanish-language description, minimal parameter documentation, and no structured output schema. The tool accepts a simple string query but lacks type definitions, enum constraints, and output format documentation. Error handling is present but returns raw errors without recovery guidance. The server demonstrates understanding of elicitation (MCP feature), but tool definition quality falls well below production standards.
Busca videos sobre un tema específico
Input schema lacks type definitions and parameter descriptions. inputSchema declares only {query: z.string()} with no constraints, enum options, or help text for the LLM.
Tool description is in Spanish ('Busca videos sobre un tema específico') with no English translation. LLM routing and understanding depends on description language matching the agent's primary language or both being provided.
Output schema is not formally documented. The tool returns hardcoded text blocks with title/url/description fields, but no JSON Schema or TypeScript interface is exposed. LLMs cannot verify expected fields or plan downstream operations.
Error handling catches exceptions but returns them to console.error and fallback defaults without structured error response. Errors lack actionable guidance for the LLM (retryable vs fatal, what to do next).
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-22 | F | 36 | 2026-07-28+ | v2 |
| 2026-03-09 | F | 32 | - | v1 |
Query parameter has no description, constraints, or length limits. LLMs receive no guidance on what constitutes a valid search term or maximum length.
Elicitation schema hardcodes enums (language, translated_or_original) without documenting why user interaction is required. Tool lacks explanation of when/why elicitation triggers vs proceeding with defaults.
Generated video results contain example/dummy URLs (example.com) instead of real endpoints. Tool is non-functional for actual use; serves only as demonstration.