OpenTopography DEM Raster Catalog

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

Annotations already declare readOnlyHint=true, openWorldHint=true, idempotentHint=true, and destructiveHint=false, so the safety profile is fully covered. The description adds valuable behavioral context: it returns dataset name, ID, DOI, format, creation date, and coverage bounds, and it notes the source and licensing (CC BY 4.0) plus rate limits (5K req/day). This goes beyond the annotations and helps an agent understand what to expect from the call.

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: it states the core function in the first sentence, then adds differentiating value (what datasets are included, what fields are returned, how it complements other tools), and ends with source/licensing/rate-limit context. Every sentence earns its place, and there is no redundant repetition of schema or annotation 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?

The description is complete for a read-only catalog search tool: it covers what the tool does, what it returns, how it differs from alternatives, and practical constraints (source, license, rate limit). The output schema exists, so return values are already structured. A minor gap is that it doesn't mention pagination or result limits, but for a catalog search with a bounding box, the provided information is sufficient for an agent to invoke 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?

Schema description coverage is 100%, with each of the four bounding-box parameters (min_lon, min_lat, max_lon, max_lat) fully documented with ranges and meanings. The description adds the context that these define a 'specified bounding box' but doesn't add new parameter-level semantics beyond what the schema already provides. Baseline 3 is appropriate since the schema does the heavy lifting.

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 searches the OpenTopography catalog for raster DEM datasets within a bounding box, and explicitly distinguishes it from standard elevation query tools by exposing niche community-contributed datasets. It names the resource (OpenTopography catalog), the action (search), and the scope (bounding box), making it easy for an agent to understand what this tool does and how it differs from siblings like opentopo.catalog.lidar or opentopodata.elevation.point.

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 says it 'Complements the standard elevation query tools by exposing niche high-resolution datasets,' which gives clear context on when to use it (when you need community-contributed or specialized DEMs beyond global datasets). It doesn't explicitly say when NOT to use it or name specific alternative tools, but the contrast with 'standard elevation query tools' is sufficient guidance 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.