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

Las anotaciones ya cubren readOnlyHint, openWorldHint e idempotentHint, por lo que la barra es más baja. La descripción añade contexto útil más allá de las anotaciones: los precios son oficiales, el orden es ascendente por precio y se incluyen rótulo, dirección y fecha de publicación. Esto comunica el comportamiento de salida sin contradecir las anotaciones.

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?

Es una sola frase sin relleno que va directa al grano: fuente oficial, ámbito geográfico, criterio de ordenación y campos devueltos. Todo el contenido aporta valor y está bien estructurado.

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 sencilla, la descripción cubre el recurso, orden y campos de salida, pero deja ambigüedad: dice que es 'para un carburante concreto' mientras que ningún parámetro es obligatorio, sin explicar qué ocurre si se omite fuel. Tampoco detalla el comportamiento de query ni el límite por defecto, aunque el esquema sí define el máximo.

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?

El esquema documenta el 100% de los parámetros, por lo que el punto de partida es 3. La descripción refuerza la idea de que el parámetro fuel es el eje central ('para un carburante concreto'), pero no añade detalles sobre limit ni query que no estén ya en el esquema. Cumple sin superar la línea base.

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 define con precisión qué devuelve la herramienta: precios oficiales de carburante en gasolineras de Alicante, para un carburante concreto, ordenados de más barato a más caro, e incluye los campos principales (rótulo, dirección y fecha oficial). Aunque no usa un verbo explícito como 'consultar' u 'obtener', el recurso y el alcance quedan claros y se distinguen fácilmente de herramientas hermanas como find_food o find_place.

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?

El uso se infiere de la descripción: sirve para obtener precios oficiales ordenados de un carburante específico en Alicante. Sin embargo, no menciona explícitamente cuándo usarla frente a alternativas como search_alicante, ni indica exclusiones o casos en los que otra herramienta sería más adecuada.

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