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

With no annotations provided, the description carries the full burden of behavioral disclosure. It states it lists locations but doesn't describe traits like whether it's read-only, if it requires authentication, rate limits, or what the output format might be (e.g., list of strings, JSON objects). This is a significant gap for a tool with zero annotation coverage.

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?

The description is a single, efficient sentence in Portuguese that directly states the tool's function without any fluff. It's front-loaded and appropriately sized, making it easy to understand at a glance.

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?

Given the tool's simplicity (0 parameters, no annotations, no output schema), the description is minimal but incomplete. It doesn't address behavioral aspects like output format or usage context, which are important even for simple tools. With no annotations or output schema, the description should do more to compensate.

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?

The tool has 0 parameters, and schema description coverage is 100%, so there's no need for parameter details in the description. The baseline for 0 parameters is 4, as the description appropriately doesn't waste space on non-existent parameters, and the schema fully covers the input structure.

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?

The description clearly states the tool's purpose: 'Listar todas as cidades/locais disponíveis para previsão' (List all cities/locations available for forecasting). It specifies the verb 'listar' and the resource 'cidades/locais', making the function unambiguous. However, it doesn't explicitly differentiate from sibling tools like 'get_weather_stations', which might also list locations, so it doesn't reach the highest score.

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?

The description provides no guidance on when to use this tool versus alternatives. It doesn't mention sibling tools like 'get_weather_stations' or explain if this is for general location listing versus station-specific data. There's no context on prerequisites or exclusions, leaving usage unclear.

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

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

With no annotations provided, the description carries full burden for behavioral disclosure. It states the tool retrieves data ('obter') which implies a read operation, but doesn't specify whether this requires authentication, has rate limits, returns real-time vs historical data, or what format/volume the data comes in. The 'recentes' qualifier suggests temporal recency but doesn't define the timeframe. For a data retrieval tool with zero annotation coverage, this leaves significant behavioral questions unanswered.

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?

The description is extremely concise - a single three-word phrase in Portuguese. While appropriately brief, it could benefit from slightly more context about what 'recent' means or what format the data returns. However, it's front-loaded with the essential action and resource, with no wasted words or redundant information.

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?

Given the tool's moderate complexity (data retrieval with geographic filtering), no annotations, and no output schema, the description is minimally adequate. It identifies the resource and action but leaves unanswered questions about data format, recency definition, authentication needs, and error conditions. The schema covers the single parameter well, but overall completeness is limited for a tool that presumably returns structured seismic data.

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?

The schema has 100% description coverage with a well-documented 'area' parameter including enum-like options and default value. The description doesn't add any parameter information beyond what's in the schema, but with only one parameter and complete schema documentation, this is acceptable. The baseline for 100% coverage with 1 parameter is appropriately high since the schema does all the work.

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?

The description 'Obter dados sísmicos recentes' (Get recent seismic data) states a clear verb ('obter' - get) and resource ('dados sísmicos' - seismic data) with a temporal qualifier ('recentes' - recent). However, it doesn't distinguish this tool from potential siblings - while no direct seismic siblings exist, the agent might wonder about differences from geological or environmental data tools. The purpose is understandable but lacks differentiation context.

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?

The description provides no guidance on when to use this tool versus alternatives. There's no mention of what makes this seismic data tool appropriate compared to weather-related sibling tools (get_weather_forecast, get_weather_warnings) or location tools (get_locations). No prerequisites, constraints, or comparative context is provided to help the agent choose appropriately.

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

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

No annotations are provided, so the description carries the full burden of behavioral disclosure. It states the tool gets a UV forecast but doesn't describe what that entails—e.g., whether it returns current or future data, if it requires location input (despite having 0 parameters), potential rate limits, or authentication needs. This leaves significant gaps in understanding how the tool behaves beyond its basic purpose.

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?

The description is a single, efficient sentence ('Obter previsão do índice UV') that directly states the tool's purpose without any waste. It's front-loaded and appropriately sized for a simple tool, making it easy to parse quickly. Every word earns its place by conveying the essential action and resource.

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?

Given the lack of annotations and output schema, the description is incomplete for a tool that might have behavioral complexities. It doesn't explain what the UV forecast includes (e.g., values, times, locations) or how it differs from sibling tools like 'get_weather_forecast'. For a tool with potential contextual nuances among weather-related siblings, more detail is needed to ensure the agent can use it correctly.

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?

The tool has 0 parameters, and schema description coverage is 100%, so there are no parameters to document. The description doesn't need to compensate for any parameter gaps, and it appropriately doesn't mention parameters. A baseline of 4 is applied since no parameter information is required, and the description doesn't add unnecessary details.

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?

The description 'Obter previsão do índice UV' clearly states the action (obter/get) and resource (previsão do índice UV/UV index forecast), which is adequate. However, it doesn't differentiate from sibling tools like 'get_weather_forecast' or 'get_weather_warnings', leaving ambiguity about scope boundaries. The purpose is understandable but lacks specificity about what distinguishes this UV forecast from other weather-related tools.

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?

The description provides no guidance on when to use this tool versus alternatives. With siblings like 'get_weather_forecast' and 'get_weather_warnings', there's no indication of whether this tool is for a specific location, time frame, or detail level. It lacks explicit when/when-not instructions or named alternatives, leaving usage context entirely implicit.

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

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

No annotations are provided, so the description carries the full burden of behavioral disclosure. It states the tool gets forecasts for cities in Portugal, but doesn't describe what the forecast includes (e.g., temperature, precipitation), how it's formatted, whether it's real-time or cached, rate limits, error handling, or data sources. For a tool with no annotation coverage, this leaves significant gaps in understanding its behavior.

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?

The description is a single, efficient sentence in Portuguese that directly states the tool's purpose. It's appropriately sized and front-loaded with the core functionality, with no redundant or verbose language. Every word earns its place by specifying the action, resource, and geographic scope.

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?

Given the tool's complexity (2 parameters, no output schema, no annotations), the description is incomplete. It lacks details on what the forecast returns (e.g., data structure, units), behavioral traits like rate limits or errors, and usage context relative to siblings. Without an output schema, the description should ideally hint at return values, but it doesn't, leaving the agent with insufficient information for effective use.

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?

The description adds no parameter semantics beyond what the input schema provides. The schema has 100% description coverage, with clear documentation for 'city' (city name with examples) and 'days' (number of forecast days, maximum 10, default 5). Since schema coverage is high (>80%), the baseline score is 3, as the description doesn't compensate with additional context like valid city formats or day-range implications.

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?

The description clearly states the tool's purpose: 'Obter previsão meteorológica para uma cidade específica em Portugal' (Get weather forecast for a specific city in Portugal). It specifies the verb ('obter' - get) and resource ('previsão meteorológica' - weather forecast), and distinguishes from siblings by focusing on city-specific forecasts rather than locations, seismic data, UV forecasts, stations, or warnings. However, it doesn't explicitly differentiate from all siblings (e.g., 'get_weather_warnings' might also be city-specific).

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?

The description provides no guidance on when to use this tool versus alternatives. It doesn't mention when to prefer this over 'get_weather_warnings' for alerts, 'get_uv_forecast' for UV data, or 'get_weather_stations' for station-specific data. There's no context about prerequisites, limitations, or typical use cases beyond the basic purpose.

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

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

With no annotations provided, the description carries the full burden of behavioral disclosure. It states the tool retrieves observation data, implying a read-only operation, but doesn't clarify aspects like data freshness, rate limits, authentication needs, or what happens if no data is available. This leaves significant gaps in understanding the tool's behavior.

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?

The description is a single, efficient sentence in Portuguese that directly states the tool's purpose without unnecessary words. It's appropriately sized for a tool with no parameters, though it could be slightly more informative without losing conciseness.

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?

Given the tool's simplicity (0 parameters, no output schema, no annotations), the description is minimal. It lacks details on what 'dados de observação' includes (e.g., temperature, humidity), how data is returned, or any behavioral traits, making it incomplete for effective agent use despite the low complexity.

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?

The input schema has 0 parameters with 100% coverage, so no parameter information is needed. The description doesn't add parameter details, but this is acceptable as there are no parameters to document. A baseline of 4 is appropriate since the schema fully covers the absence of parameters.

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?

The description 'Obter dados de observação das estações meteorológicas' (Get observation data from weather stations) states a clear verb ('Obter') and resource ('estações meteorológicas'), but it's vague about what specific data is retrieved and doesn't distinguish from siblings like 'get_weather_forecast' or 'get_weather_warnings'. It provides a basic purpose but lacks specificity.

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?

No guidance is provided on when to use this tool versus alternatives such as 'get_weather_forecast' for forecasts or 'get_weather_warnings' for alerts. The description implies usage for observational data but doesn't specify contexts, exclusions, or prerequisites, leaving the agent to infer based on tool names alone.

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

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

With no annotations provided, the description carries full burden but provides minimal behavioral information. It doesn't disclose whether this is a read-only operation (implied by 'get'), what data format is returned, whether there are rate limits, authentication requirements, or how current the warning data is. The description states the basic purpose but lacks operational context needed for effective tool use.

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?

Perfectly concise single sentence in Portuguese that communicates the essential purpose: get active weather warnings in Portugal. No wasted words, no redundant information, and front-loaded with the core action. The structure is optimal for a simple tool with no parameters.

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?

Given no annotations, no output schema, and a simple zero-parameter design, the description is insufficiently complete. It doesn't explain what format the warnings come in (text, codes, severity levels), whether it returns all warnings or needs filtering, temporal aspects (how 'active' is defined), or error conditions. For a weather warning tool where users need to understand the nature and format of warnings, this leaves significant gaps.

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?

The tool has zero parameters with 100% schema description coverage, so the schema fully documents the parameter situation. The description appropriately doesn't discuss parameters since none exist. It earns a 4 rather than 5 because while it correctly avoids parameter discussion, it doesn't explicitly state 'no parameters required' which could help clarify the zero-parameter design.

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?

The description clearly states the verb ('Obter' meaning 'Get') and resource ('avisos meteorológicos ativos' meaning 'active weather warnings') with geographic scope ('em Portugal' meaning 'in Portugal'). It distinguishes from siblings like get_weather_forecast (forecasts vs warnings) and get_seismic_data (different hazard type). However, it doesn't specify whether it returns all warnings or filtered subsets, which prevents a perfect score.

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?

No explicit guidance on when to use this tool versus alternatives. The description implies it's for active warnings in Portugal, but doesn't clarify when to choose this over get_weather_forecast (which might include warning information) or get_seismic_data (for different hazard types). No mention of prerequisites, frequency of updates, or limitations.

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