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

No annotations are provided, so the description carries the full disclosure burden. It states only that a problem is acknowledged, omitting that this is a state-changing action with consequences such as notifications suppression, sticky ack persistence, and comment recording. The schema reveals sticky/notify options, but the tool's broader behavior is not disclosed.

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 one clean, front-loaded sentence with no filler. It is concise, although it is concise at the expense of missing valuable usage and behavior context.

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?

With no annotations and only a single sentence, the description is incomplete for a state-changing tool: it does not state the expected effect, any prerequisite like the problem needing to exist, or how this differs from related tools. The full schema explains parameters but not when and why the operation is appropriate.

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?

Schema description coverage is 100%, with useful per-parameter descriptions for host_name, service_description, sticky, notify, and comment. The tool description itself adds no parameter meaning, but the schema already does most of the work, so a baseline of 3 is appropriate.

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 names a specific Nagios operation, 'Acknowledge', and clarifies the target resource as a host or service problem. It is clear enough for selection, though it does not explicitly distinguish itself from nagios_add_comment_tool, which could be a plausible alternative.

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 gives only a general situation ('a Nagios host or service problem') and no guidance about when to use acknowledgment versus attaching a comment, checking status, or scheduling a check. There is no when-not or alternative routing, so an agent is left to infer its decision from sibling 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, the description carries the full behavioral burden; it does disclose that comments are persistent, which is useful. However, it does not mention that this is a mutating operation, whether permissions are required, or how existing comments or host/service state are affected.

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?

Exactly one sentence, front-loaded with the action and destination, with no filler or redundant wording. Every word contributes to meaning.

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?

For a simple 3-parameter write tool with a full schema and output schema present, this description is sufficient. It conveys the persistent nature of the action, the host/service difference, and the purpose, leaving little an agent needs to infer.

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?

Schema coverage is 100%, so the schema already explains each parameter. The description adds the 'host or service' context matching host_name and service_description, but it doesn't provide any additional semantic detail beyond what the schema already gives.

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 states a specific verb ('Add') and resource ('persistent comment to a host or service in Nagios'), immediately distinguishing this from siblings like status checks or scheduling. The 'persistent' detail and host/service scoping make the tool's role unambiguous.

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 implies usage whenever a persistent comment needs to be attached to a Nagios host or service, but provides no explicit guidance on when not to use it or which sibling to choose instead. For instance, it doesn't contrast with nagios_acknowledge_tool, which is the closest alternative for problem ownership.

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 behavioral burden. It clearly conveys read-only behavior through 'List' and discloses what the return will be: a summary or confirmation that everything is OK. It does not mention potential edge cases like how acknowledged problems are handled, but for a simple listing tool this is acceptable.

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 two sentences, front-loads the tool's main purpose, and has no filler or repetition. Every sentence contributes useful 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?

For a zero-parameter list tool with an output schema, the description fully covers what the tool does and what the caller should expect. No additional context about invocation arguments or output semantics is needed.

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?

There are no parameters, and schema coverage is 100%, so the description need not add parameter details. The baseline for zero-parameter tools is 4, and the description correctly stays out of indicating nonexistent inputs.

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 a specific verb ('List') and resource ('all hosts and services currently in a non-OK state'). It also distinguishes itself from siblings that focus on individual host or service status, making its purpose immediately obvious.

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 implies this is the tool to use for a high-level current-problem summary across hosts and services, but it does not explicitly state when not to use it or name alternatives. The context is clear enough for an agent to choose it appropriately, though exclusions are absent.

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. The word 'Get' implies a read-only, non-destructive query and 'current' suggests a live snapshot, but the description does not clarify potential error conditions, required permissions, or whether the status is cached or freshly queried.

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 clear, front-loaded sentence with no wasted words. It immediately communicates what the tool does.

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?

This is a simple one-parameter read-only query tool with an output schema, so the description is largely sufficient. It could explain how host status is determined or what happens for unknown hosts, but the minimal scope keeps the definition reasonably complete.

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 describes host_name as 'The Nagios hostname to query' with 100% coverage. The tool description adds no extra meaning beyond the schema, so the baseline score of 3 is appropriate.

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 action ('Get'), the resource ('a Nagios host'), and the specific kind of information ('current status'). It also distinguishes the tool from siblings that target services or perform actions like acknowledging or adding comments.

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 implies the tool is for host-level status queries, which separates it from service status and other action-oriented siblings. However, it does not explicitly state when to prefer this tool over nagios_service_status_tool or when it should not be used.

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 burden. 'Retrieve' clearly signals a read-only operation, and 'recent notification history' defines a temporal scope. It does not describe sorting or pagination, but the presence of an output schema partly covers what an agent would need about the result shape.

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?

One short, front-loaded sentence that states the action and the resource with no wasted wording, filler, or repetition of schema content.

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?

For a simple read-only retrieval with two optional and fully documented parameters plus an output schema, the description is almost sufficient. The only real gap is explicit usage guidance relative to sibling tools, which is a minor omission rather than a blocking one.

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 already provides 100% parameter description coverage: hours has a meaningful description and default, and host_name is explicitly explained. The description itself adds no extra parameter semantics, so the baseline score of 3 applies.

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 names a specific verb and resource: retrieve notification history from Nagios. This clearly separates it from sibling tools that report host/service status or current problems, and from the modifying tools in the sibling list.

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 intended use case is implied by the name and resource ('history'), but the description gives no explicit guidance on when to prefer this tool over siblings, nor any 'not for this' examples. An agent can infer the use case, but it is not stated directly.

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. It discloses key behavioral traits: detects a wedged daemon (CGI returns 200 but stale status data), globally disabled notifications, disabled check execution, and raises on connection failure so a dead Nagios cannot be read as healthy. This goes well beyond a simple 'check status' statement.

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 well-structured and front-loaded: the first sentence states the core purpose, followed by usage guidance, then behavioral details. Every sentence earns its place, and the contrast with the sibling tool is concise and informative.

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 (one optional parameter, no required params, output schema present), the description is complete. It covers what the tool does, when to use it, what it detects, and how it behaves on failure. The output schema handles return values, so no further description is needed.

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?

Schema description coverage is 100%, so the schema already documents the parameter. The description adds context by explaining the default (60) and the refresh rate (~10s), which helps the agent reason about appropriate values. It doesn't need to do much more since there is only one parameter and it is fully described.

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 states a specific verb ('Check whether the Nagios daemon itself is alive and actually working') and resource (the Nagios daemon), and explicitly distinguishes it from nagios_current_problems_tool. It clearly identifies what the tool is for: verifying the monitoring system, not finding outages.

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 explicitly says when to use this tool ('a watchdog asking is Nagios still able to tell me about problems?') and contrasts it with nagios_current_problems_tool, explaining why that alternative is not suitable (returns 'no problems' both when all is well and when Nagios has silently stopped working). This is clear when-to-use and when-not-to-use guidance.

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, the description must carry the behavioral disclosure burden. It does convey an important trait: this is a scheduling action, not a synchronous check, and it is 'forced' and 'immediate'. However, it does not mention side effects, whether an existing check is replaced, or what happens after scheduling, leaving some behavior unstated.

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?

One concise sentence with zero filler. It front-loads the key verb 'Schedule' and then the resource. Nothing unnecessary and no redundant repetition of the 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?

For a simple two-parameter tool with a full output schema and full schema coverage, the description gives sufficient context to invoke the tool correctly. It lacks only explicit guidance on when to use it among siblings, but the schema and output schema cover most operational needs.

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?

Schema description coverage is 100% for both parameters: 'host_name' is described as the hostname to check, and 'service_description' as the service name with an explicit note to omit it for host checks. The tool description adds no additional parameter insight beyond the schema, so a baseline of 3 is appropriate.

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 uses a specific verb ('Schedule') and resource ('a forced immediate re-check of a host or service'), making the tool's core action unmistakable. It also distinguishes this from the sibling status, history, and comment tools, which are all different operations.

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 when-to-use guidance is provided, nor any exclusions or mention of sibling alternatives. The description states what the tool does but not the circumstances under which it should be preferred over a status check, acknowledgment, or comment tool.

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. 'Get the current status' states the action but not the behavior behind it — for example, whether the result is a cached/last-known state or how it relates to a fresh check (which nagios_schedule_check_tool exists for). The description does not contradict any annotations, but it also discloses nothing beyond the name itself.

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?

A single, front-loaded sentence with zero filler; the verb and resource are presented first and the sentence is tightly scoped. It is not bloated, though it is so minimal that it skips valuable routing context that other dimensions penalize.

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?

The tool is simple (2 required params, no nesting, an output schema present), so the schema and output structure cover the mechanics of a call. What is missing is specifically the selection context: with six sibling tools spanning hosts, services, problems, acknowledgements, scheduling, and history, the one-line description is not enough on its own to guarantee correct tool choice.

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?

Schema description coverage is 100%, with both host_name and service_description documented — including a concrete example ('HTTPS crunchtools.com') for service_description. The description's prose adds no parameter-level meaning, but per the baseline, the schema already does the heavy lifting, so a 3 is appropriate.

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 combines a specific verb ('Get'), a specific resource ('current status of a specific service on a host'), and implicitly differentiates from the sibling nagios_host_status_tool by focusing on service-level rather than host-level state. It does not explicitly name a sibling or state what the tool is not, so it falls just short of a 5.

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 offers no guidance on when to use this tool versus alternatives such as nagios_host_status_tool, nagios_current_problems_tool, or nagios_schedule_check_tool. There are six siblings with overlapping Nagios domains, and the description gives the agent no rule for choosing among them, no exclusions, and no prerequisites.

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