Retrieve complete assignment details by providing its course module ID or URL, including description, deadlines, attachments, and submission status.
Detalle de una tarea (mod/assign): descripción, fechas, archivos adjuntos y estado de la entrega del usuario. Acepta el cmid numérico o la URL completa (https://.../mod/assign/view.php?id=NNN).
| Name | Required | Description | Default |
|---|---|---|---|
| cmid_or_url | Yes |
Changes observed during successful MCP inspections.
v0.1.0Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Al no haber anotaciones, la descripción asume toda la carga de divulgación. 'Detalle' sugiere una operación de lectura y los campos enumerados indican lo que recibirá el agente, pero no declara explícitamente que sea no destructiva ni menciona requisitos de permisos o comportamiento ante errores.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Dos oraciones compactas, con la información principal (campos devueltos) al inicio y el formato de entrada a continuación. No hay relleno ni repetición de lo que ya está en el nombre o en el schema.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
La herramienta es simple (un parámetro, sin schema de salida ni anotaciones) y la descripción cubre tanto la sintaxis de entrada como el contenido devuelto. Faltan detalles menores sobre condiciones de error y la naturaleza explícitamente de solo lectura, pero son de bajo riesgo para una herramienta de consulta.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Con una cobertura de descripción del schema del 0%, la descripción compensa plenamente al explicar los formatos aceptados: 'Acepta el cmid numérico o la URL completa (https://.../mod/assign/view.php?id=NNN)'. Esto resuelve la ambigüedad de formato del único parámetro.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
La descripción identifica claramente el recurso ('tarea (mod/assign)') y enumera el contenido devuelto ('descripción, fechas, archivos adjuntos y estado de la entrega del usuario'), lo que hace evidente la función de la herramienta. No menciona herramientas hermanas ni las diferencia, por lo que no alcanza la puntuación máxima.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Se infiere el contexto de uso: cuándo se necesita el detalle de una tarea mod/assign. Explica cómo identificar la tarea mediante cmid o URL, pero no incluye cuándo no usarla ni alternativas explícitas, por lo que la guía es implícita en lugar de explícita.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.