Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Las anotaciones ya cubren readOnlyHint, idempotentHint y openWorldHint, por lo que la barra de transparencia obligatoria es baja. La descripción añade valor al revelar el contenido de la «ficha» (servicios, accesibilidad, URL canónica), el alcance geográfico y el carácter vigente de la bandera. No contradice ninguna anotación.

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 frases compactas que sitúan el propósito principal al principio y presentan inmediatamente los filtros disponibles. No hay repetición de la información del schema ni relleno innecesario.

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?

Para una herramienta de consulta de solo lectura, idempotente y de mundo abierto, la descripción cubre alcance, criterios de filtrado y contenido de retorno a pesar de no haber output schema. Podría ser más explícita sobre la forma de la lista o los valores posibles de la bandera, pero el agente tiene suficiente información para invocarla correctamente con parámetros opcionales.

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?

Los tres parámetros tienen descripciones en el schema, por lo que la cobertura es del 100% y se aplica el nivel base. La descripción añade la relación entre beach y municipality con «Acota por nombre de playa o municipio», pero no aporta nada nuevo sobre limit. El valor añadido es útil pero limitado.

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 (playas de Alicante y municipios próximos) y el contenido devuelto: bandera vigente, estado, servicios, accesibilidad y URL canónica. Aunque no emplea un verbo principal como «devuelve» u «obtiene», la instrucción «Acota por nombre de playa o municipio» precisa la operación. El ámbito específico de playas la distingue de herramientas hermanas genéricas como find_place o weather_now.

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?

La frase «Bandera vigente y estado de las playas» implica cuándo usar la herramienta: cuando se necesita información actual de bandera, servicios o accesibilidad de playas en Alicante. Sin embargo, no menciona explícitamente alternativas ni cuándo no usarla, dejando la decisión de routing a la inferencia del agente.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.