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

The annotations already mark the tool as non-read-only, and the operation names imply creation, but the description adds no behavioral context beyond that. It does not mention side effects on the drawing, error behavior, coordinate-system assumptions, or what happens after a successful operation.

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 compact, well-structured as a scannable operation list, and every line adds useful information. There is no filler or redundant restating 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?

Given the generic schema, the description is nearly complete: it covers all operations and their payload shapes. Minor gaps include undocumented behavior of include_screenshot and lack of explicit units or coordinate context, but these do not prevent correct operation selection.

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 is generic and has 0% schema description coverage, so the description carries the full burden. It compensates thoroughly by defining the exact data object shape expected for every operation, including required fields and optional markers.

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 the resource ('Annotation') and enumerates six specific creation operations (text, dimension variants, leader), so an agent knows exactly what the tool does. It is clearly distinguishable from sibling tools like drawing, entity, and layer by its scope.

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 opening line 'Annotation: text, dimensions, and leaders' plus the operation list gives a clear context for when to use this tool. It does not explicitly name alternatives or exclusions, but the intended usage is obvious enough for an agent to select it 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?

With readOnlyHint=false, the description's listing of mutating operations (insert, update_attribute, define) is consistent with the annotation. It adds operation-level context but does not disclose side effects, coordinate assumptions, failure behavior, or what happens when metadata is updated.

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 compact and front-loaded with a one-line summary followed by a structured operation list. Every operation gets a single line with its data payload, and there is no filler or redundant restating of schema fields.

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 six-operation dispatch tool with a generic data field and no enums, the description provides the necessary operation vocabulary and rough data contracts. However, requiredness of fields like x/y/name is not marked, and deeper semantics for define and attribute operations are left vague.

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 0%, so the description carries the parameter documentation burden, and it does so with per-operation data shapes including optional markers for scale, rotation, and block_id. It still leaves some fields under-specified, such as the entities array in define, attribute value types, and include_screenshot semantics, but the core data contracts are understandable.

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 opening line scopes the tool to block definition, insertion, and attribute management, and the operation list enumerates distinct verbs such as list, insert, define, get_attributes, and update_attribute. This clearly identifies the resource and actions, distinguishing it from sibling drawing, entity, and layer 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 implies block-related usage through the operation list, but it does not explicitly state when to use this tool versus siblings like entity or layer. There is no exclusion guidance or comparison to alternatives, so an agent must infer the appropriate context.

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 readOnlyHint=false, the tool is already marked as potentially mutating, and the description adds meaningful behavioral details: save mentions QSAVE fallback, undo/redo state operations, and purge targets unused objects. It does not disclose destructive side effects (e.g., purge deleting data permanently), but the per-operation explanations go well beyond the bare annotation.

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 tightly formatted bullet list with no filler. Each line adds one distinct operation plus a brief explanation and data hint, and the overall purpose is front-loaded in the first line.

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 ten-operation dispatcher, the description covers each operation's function and relevant data requirements, and an output schema exists to cover return values. The main gap is the unexplained `include_screenshot` parameter, which prevents the description from being fully 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?

Schema description coverage is 0%, so the description is the only documentation of valid `operation` values and `data` structures. It lists all operations and gives per-operation data hints such as `data: {path}` for open and `data: {names: [...]}` for get_variables. However, the `include_screenshot` parameter is never mentioned, leaving one parameter undocumented.

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 opens with "Drawing file management" and then enumerates ten distinct operations, each with a verb and a resource (e.g., "create — Create a new empty drawing," "plot_pdf — Plot to PDF"). This makes the dispatcher's purpose and each subcommand unambiguous. Although sibling tools are not referenced, the operations are clearly scoped to whole-drawing management, distinguishing it from entity/layer/block 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 operation list implicitly tells an agent when to use this tool (e.g., when saving or opening a drawing), but there are no explicit when-not-to-use statements or pointers to siblings like entity, layer, or block. Usage context is conveyed indirectly through the operation names, not through explicit routing 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?

Annotations only supply readOnlyHint=false, so the description carries the burden. The operation list correctly reflects mutating and read-only behaviors, but does not mention side effects, prerequisites such as an open drawing, or the meaning of the include_screenshot flag.

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 content is organized into Create/Read/Modify groups with one line per operation, and every line adds a signature or behavior. The summary sentence is front-loaded and there is no filler.

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 19 operations and only 1 required schema parameter, the description covers most of what an agent needs to choose and call an operation. It would be more complete if it explicitly stated that operation must be set to one of the listed names and described include_screenshot.

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?

With schema_description_coverage=0%, the operation-specific parameter shapes such as create_circle data: {cx, cy, radius} and offset data: {distance} provide crucial meaning absent from the schema. It still leaves some semantics implicit, such as angle/factor units and accepted operation strings.

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 opening line 'Entity creation, querying, and modification' names the resource and the three verb families, and the operation list makes the scope concrete. It lacks explicit differentiation from siblings like drawing or block, so it stops short of 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?

It clearly signals this is the tool for entity-level operations such as create_line, list, move, and erase rather than drawing/session-level tasks. There is no explicit 'when-not-to-use' or direct pointer to a sibling, but the context is unambiguous.

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 readOnlyHint=false, the annotations already signal mutation; the description goes further by itemizing mutating operations such as create, set_current, set_properties, freeze, thaw, lock, and unlock. It does not disclose side effects or reversibility, but the operation list provides meaningful behavioral detail beyond the annotation.

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 compact, front-loaded summary followed by a bulleted operation list with minimal syntax. Every line adds information, and it avoids redundancy with 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 multi-operation layer tool with a sparse schema, the description covers the core call shape well: operation names and per-operation data. The output schema presumably handles return-value documentation, so the main remaining gap is the unexplained include_screenshot parameter and lack of explicit required-field notes. Overall it is adequate for an agent to invoke most operations 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?

Schema description coverage is 0%, so the description must carry parameter meaning; it does so by listing valid operation strings and showing the expected data object shape for each operation (e.g., create data: {name, color?, linetype?}). However, it leaves include_screenshot completely undocumented and does not explicitly mark which fields within data are required.

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 opens with 'Layer creation and management' and then enumerates eight specific operations (list, create, set_current, set_properties, freeze, thaw, lock, unlock), making both the resource (layers) and the actions concrete. This clearly separates it from sibling tools like entity, block, or view.

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 operation list implies the tool is for any layer-management task, but the description never explicitly states when to choose it over a sibling tool or when not to use it. No prerequisites, exclusions, or alternative tools are mentioned, so usage guidance is only 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?

The description reveals that operations mutate the drawing by creating layers, inserting symbols, and connecting equipment, which is consistent with the readOnlyHint=false annotation. It does not disclose prerequisites such as whether setup_layers must be called first, coordinate system expectations, or the effect of include_screenshot. It adds operation-level behavior but not deeper behavioral context.

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 tight, consistently formatted operation list with no filler. The domain statement is front-loaded, and every line adds a distinct operation or data shape. It is an excellent model of concise reference documentation.

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 multi-operation dispatch tool, the description covers all operation names and their data payloads, and an output schema exists so return-value documentation is not essential. It is slightly incomplete around the include_screenshot parameter and setup ordering, but otherwise sufficient for correct invocation.

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 0%, but the description lists the expected data keys for each operation, including optional fields marked with '?'. This substantially compensates for the generic schema. The only structured parameter not explained is include_screenshot, which prevents a 5.

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 opening phrase 'P&ID drawing with CTO symbol library' plus the enumerated operations (setup_layers, insert_symbol, draw_process_line, etc.) makes the tool's purpose concrete. It stops short of a clean single verb+resource statement and does not explicitly contrast with sibling drawing/layer tools, so it earns 4 rather than 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 operation list implies when to use this tool, such as when inserting P&ID symbols or drawing process lines. However, it never explicitly states when to prefer this tool over sibling tools like drawing, layer, or block, and it gives no exclusions. Guidance is implied rather than explicit.

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?

The annotations declare readOnlyHint=true, but the description includes operations 'init' (re-initialize backend) and 'execute_lisp' (execute arbitrary AutoLISP code) which are clearly mutating or potentially destructive. This directly contradicts the read-only annotation. The description also fails to disclose side effects or safety implications of these operations.

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 with a clear summary and a bulleted list of operations, each with a brief explanation. It is concise without unnecessary verbosity, though the inclusion of potentially dangerous operations warrants more cautionary wording.

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 description lists operations but fails to explain return values, error handling, permissions, or the behavior of the 'include_screenshot' parameter. Given the tool's complexity and the presence of potentially destructive operations, the description is insufficient for an agent to use all features safely and 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 description adds meaning by listing valid values for the 'operation' parameter and specifying that 'execute_lisp' takes data with a 'code' field. However, it omits any discussion of the 'include_screenshot' parameter and does not clarify whether other operations use 'data', leaving gaps in parameter understanding.

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 identifies the tool as 'Server status and management' and enumerates specific operations (status, health, get_backend, runtime, init, execute_lisp), giving a clear idea of the resource and actions. It does not explicitly contrast with sibling tools, but the system focus is evident from the operation 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?

No guidance is provided on when to use this tool versus alternatives like drawing, entity, or layer tools. There is no mention of prerequisites, exclusions, or typical use cases beyond listing operations, so agents must infer usage from operation names.

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?

Annotations already provide readOnlyHint=true, lowering the burden; the description adds operation semantics and notes that get_screenshot returns a PNG. However, it does not disclose the coordinate space for zoom_window (model/world vs screen), whether coordinates are effectively required despite schema null defaults, or what happens if coordinates are omitted or passed with other operations.

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 one-line purpose statement followed by three bullet-style operation lines; every sentence earns its place. The purpose is front-loaded, and each operation is a single scannable line with no redundant filler.

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 dispatcher with an unconstrained operation parameter and no enums, the description supplies the critical operation vocabulary that the schema lacks, and the output schema presumably covers return values. However, it leaves notable gaps: coordinate semantics for zoom_window, whether coordinates are required for that operation, and whether the coordinate parameters should be null for the other two operations.

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?

With 0% schema description coverage, the description partially compensates: 'zoom_window — Zoom to window: x1, y1, x2, y2' maps the four numeric parameters to the operation that consumes them, and the Operations list is the only source of valid values for the unconstrained operation string. But it leaves coordinate ordering, units, and coordinate system unspecified, and does not clarify that x1/y1/x2/y2 are effectively required for zoom_window even though the schema marks them optional with null defaults.

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 clear purpose ('Viewport control and screenshot capture') and enumerates three distinct operations, each with a specific verb, resource, and effect (zoom_extents, zoom_window, get_screenshot). It is immediately distinguishable from sibling tools like drawing, entity, or layer, which cover different AutoCAD domains.

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 operation list gives implicit selection guidance — zoom_extents for showing everything, zoom_window for a specific region, get_screenshot for capturing PNG output. However, there is no explicit when-to-use wording, no exclusions, and no stated alternative among the sibling tools; the domain separation from drawing/entity/layer/block is only implied by names.

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