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

The description mentions 'auto paging' and a max_pages parameter, implying it fetches multiple pages. However, it does not disclose whether the tool is read-only, has side effects, or the nature of pagination (sequential vs parallel). With no annotations, the description provides moderate but incomplete behavioral insight.

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 concise, using a title line and an Args section. It efficiently conveys the tool's purpose and parameters without extra words. However, the order parameter explanation could be slightly more structured (e.g., listing meaning of each suffix).

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 covers parameter semantics well but lacks usage context, such as how auto-paging works, limits, or when to prefer this over get_articles. Given the output schema exists, return values are not needed, but behavioral and contextual details are missing for a comprehensive understanding.

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 fully explains each parameter: complex_no as complex code, trade_type with three options (매매, 전세, 월세 via codes A1/B1/B2), order with three choices (가격순/면적순/최신순 via codes), and max_pages as page limit. This compensates for 0% schema coverage, though order value suffixes are not explained (e.g., ascending vs descending).

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 '단지별 매물 전체 (자동 페이징)' meaning 'All articles by complex (auto paging)'. It specifies the scope (all articles for a complex) and a key feature (automatic paging), which distinguishes it from sibling tools like get_articles.

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 get_articles or search_listings. There is no mention of prerequisites, performance considerations, or explicit scenarios for choosing this 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?

The description discloses that only the first page is returned (1페이지). Without annotations, this is useful behavioral information. However, it does not mention rate limits, authentication needs, or data freshness, leaving gaps.

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 concise and structured with a header and argument list. Every sentence adds value, though the Korean text could be slightly more compact. No unnecessary 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?

Given the output schema exists, return value explanation is not needed. However, the description does not mention pagination details beyond the first page, default page size, or how to get subsequent pages. This limits completeness for a paginated list tool.

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 thorough explanations for all parameters: complex_no (source), trade_type (values A1/B1/B2), order (values prc_/spc_/date_), and page (number). The schema had 0% description coverage, so this fully compensates.

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 it returns a list of listings per complex (단지별 매물 목록) and explicitly limits to the first page. This clearly indicates the tool's scope. However, it does not differentiate from sibling tools like get_all_articles, which could fetch all pages.

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 lists trade types and sort orders, providing some usage guidance. However, it does not explain when to use this tool versus alternatives, nor does it specify prerequisites or exclusions.

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 must carry the full burden. It only lists the parameter and example fields but fails to disclose behavioral traits such as whether the operation is read-only, requires authentication, or has rate limits. The description is minimal.

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 short, containing both Korean and English text. It is mostly concise, but the parameter description is redundant with the schema. It could be more streamlined.

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 that an output schema exists, the description does not need to explain return values. The tool has only one parameter and the description covers its purpose. However, due to the lack of behavioral transparency and usage guidelines, the description is minimally 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 must add meaning. It provides 'complex_no: 단지 코드' (complex code) which is a minor addition, but does not explain the format or source of the code. The description adds limited value beyond the schema.

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 '단지 상세 정보' (complex detail info) and lists example fields (households, area, move-in year, construction company). It distinguishes from siblings like 'get_complexes' which likely lists complexes, and 'get_price_info' etc.

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 for retrieving detailed info for a specific complex, but provides no explicit guidance on when to use this tool vs alternatives, nor any exclusions or prerequisites.

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 disclose behavior. It reveals an automatic fallback on rate limiting, which is a key behavioral trait. However, it does not mention other aspects like authentication, read-only nature, or error states. The disclosure is partial but adds value.

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 short, starting with the core purpose, then the behavioral note, then parameter documentation. Every sentence contributes without redundancy. It is efficiently structured for an AI agent to parse quickly.

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 has only 2 parameters and an output schema, the description covers purpose, parameters, and a critical behavioral quirk (rate limit fallback). It lacks mention of authentication or pagination, but the output schema likely handles return details, making it 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?

Schema description coverage is 0%, so the description bears full responsibility. It explains cortar_no as a 10-digit administrative district code and lists real_estate_type values (APT, OPST, VL etc.), with a default noted. This provides essential meaning absent from the schema.

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 explicitly states the tool retrieves a list of complexes for a specific neighborhood, with a clear verb (조회/retrieve) and resource (단지 목록/complex list). This distinguishes it from siblings like get_complex_detail (single complex) and search_listings (property listings).

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 a specific usage scenario: when rate-limited, the tool auto-switches and directs to search_listings. This gives agents a conditional alternative. However, it doesn't cover when to prefer this tool over other siblings in normal conditions.

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, and the description does not disclose behavioral traits such as read-only nature, authorization requirements, or rate limits. It only parameter details.

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 relatively concise but includes unnecessary formatting like 'Args:' and line breaks. The key information is front-loaded, but could be more streamlined.

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 that an output schema exists, the description adequately covers parameter usage. However, it lacks context on what the output contains or how to interpret the results.

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 adds critical meaning: trade_type codes and year default. It also hints at area_no source (get_complex_detail → pyeongNo). However, complex_no is not explained further.

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 it provides market price/actual transaction price trends, with a clear list of parameters. It distinguishes itself from siblings like get_complex_detail and get_region_info, but could more explicitly differentiate.

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 on when to use this tool versus alternatives. The description only lists parameters without specifying use cases or exclusions.

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 full responsibility. It mentions that the tool is 'rate limit 강건' (robust against rate limits), which is a behavioral trait. However, it does not explicitly state that the operation is read-only or safe, nor does it disclose any potential side effects or permission requirements. Given the lookup nature, a 3 is appropriate.

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 relatively concise, with a lead sentence summarizing the tool, followed by a usage hint and parameter documentation. Each sentence adds value, though the parameter descriptions could be slightly more succinct. Still, it is well-structured and front-loaded.

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 (3 parameters, output schema exists) and the presence of sibling tools, the description covers the necessary context: what it does, when to use it (vs search_regions), how to use outputs, and parameter details. The output schema existing means describing return values is unnecessary, so no gap.

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 provides detailed meaning for all three parameters: cortar_no is '지역 코드 (읍면동 10자리)', real_estate_type includes examples like 'APT, OPST, VL 등', and trade_type lists A1, B1, B2 with their Korean equivalents. This significantly adds value beyond the bare schema.

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 that the tool retrieves region information and coordinates (지역 정보 + 좌표 조회) based on cortarNo. It specifies the outputs: exact coordinates, region name, and cluster count. It distinguishes itself from siblings by mentioning it is an alternative when search_regions is rate-limited.

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 tells when to use this tool: as an alternative when search_regions hits rate limits. It also explains how the output can be directly used in search_listings, providing integration guidance. No contradictory usage advice is given.

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 present, so the description must carry the full burden of behavioral disclosure. The description only states what the tool does, not any behavioral traits such as data freshness, authentication requirements, error handling, or any side effects. This is insufficient for an agent to understand 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 very concise, consisting of a single line and an Args section. While it is front-loaded with the main purpose, it lacks additional context that could be provided without adding much length. It is not overly verbose but misses opportunities to add value.

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 has one parameter and an output schema (though not shown), the description is still incomplete. It does not explain what the output contains, how to interpret the results, or any edge cases. For a simple tool, a slightly richer description would be expected.

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 0% description coverage, meaning the parameter complex_no only has a title and type. The description adds '단지 코드' (complex code), which provides minimal semantic value. It does not explain the format (e.g., numeric, alphanumeric), how to obtain it, or any constraints.

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 that the tool retrieves school districts around a complex (elementary, middle, high school). It uses specific nouns and verbs, making the purpose understandable. However, it does not distinguish itself from siblings like get_complex_detail or get_region_info, which could also provide location-related data.

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. There is no mention of prerequisites, context, or scenarios where this tool is appropriate. For example, it does not explain if it should be used after obtaining a complex_no from another 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 must cover behavioral traits. It mentions stability and parameter defaults but does not disclose side effects, authentication needs, rate limits, or response structure. Some transparency is present in parameter behavior (e.g., max_pages).

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 bold title, explanatory text, and a parameter list. It is front-loaded with purpose. Slightly verbose due to repeated explanations of code formats, but overall efficient.

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 parameter count of 7 and 2 required parameters, the description covers input semantics well. It does not mention output schema (which exists) or return value details, but that is acceptable. It also explains pagination via max_pages. Missing a note on output structure or error handling.

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 fully compensates by providing detailed explanations for all 7 parameters, including examples, allowed values (trade types, property types), defaults, and the meaning of delta and max_pages. This is excellent coverage.

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: 'coordinate-based listing search (most stable method)'. It distinguishes itself from get_region_info (used as a prerequisite) but does not explicitly differentiate from other siblings like get_articles or get_complex_detail.

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 advises using get_region_info first to verify coordinates and explains trade/property type codes. It provides context for when to use (coordinate-based search) but does not specify when not to use or mention alternative tools.

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 provided, so description carries full burden. It discloses hierarchical navigation, default code, and rate limit fallback. Does not detail error handling for invalid codes, but output schema exists and read-only nature is clear from 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?

Description is concise with bullet points and a clear example. Front-loaded with purpose. Minor redundancy (e.g., '지역 검색' repeated), but overall efficient.

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 single parameter and existence of an output schema, the description covers hierarchy, default, example, and fallback. Lacks details on error cases or edge conditions, but adequate for a fairly simple tool.

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%, requiring description to compensate. It fully explains the parameter 'cortar_no' as a 10-digit region code with default for entire country, and demonstrates usage in the example. This adds significant meaning beyond the schema.

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?

Description clearly states the tool is for region search with hierarchical exploration (시도 → 시군구 → 읍면동). It provides specific verb 'search/explore' and resource 'regions hierarchy', distinguishing it from sibling tools like get_complexes or get_articles.

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?

Explains step-by-step usage with examples and default behavior. Missing explicit 'when not to use', but context from sibling tools and the description itself implies it's for region code navigation only. Mentions automatic fallback for rate limiting.

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