search_reduction_ordinance

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

No annotations are provided, so the description carries the burden. It discloses the tool's role in the tax workflow and cites the legal basis, implying this is a read-only search operation. However, it doesn't describe pagination behavior, result format, whether results come from a live API vs cache, or rate/auth considerations. The legal-citation context adds value but behavioral traits beyond search semantics are 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 a tight two-sentence paragraph that front-loads the core purpose (searching ordinances for tax reduction/rates) and packs legal citations and workflow context efficiently. The Korean text is dense but every clause earns its place, introducing the legal basis, the positioning relative to national tax tools, and the region-accuracy tip. Slightly dense for non-Korean readers but well-structured.

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 tool has meaningful complexity: no output schema, 6 parameters with 2 undocumented (oc, page), and no annotations. The description compensates reasonably by explaining the legal framework, workflow timing, and positioning against national tax tools. However, it doesn't clarify the return format (result count, fields), the meaning of oc and page parameters, or filtering semantics of localTaxOnly beyond schema text. Good for a search tool, but leaves the oc and page gaps unaddressed.

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 67% with 3 of 6 parameters described (query, region, display, localTaxOnly have descriptions; oc and page do not). The description adds strategic meaning beyond the schema: it emphasizes that specifying region (지자체명) significantly improves accuracy, which is the description's most actionable parameter guidance. It also frames query as keyword enrichment. However, oc and page remain undocumented in description, leaving some gap.

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+resource: searching municipal reduction ordinances and tax rate ordinances in the legal affairs bureau (법제처) local ordinance database. It clearly distinguishes from national tax MCP tools by noting this is a missing axis (축) not covered by national tax tools. However, it doesn't explicitly name sibling alternatives for differentiation, and the purpose is embedded in a dense two-sentence paragraph.

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 clear context on when to use: before concluding tax amounts (세액 결론 전 반드시 확인), because local taxes rely on ordinances for flexible rates and exemptions per specific legal provisions (지방세법 §111③, 지방세특례제한법 §4). It notes specifying the municipality (지자체명) greatly improves accuracy. It doesn't explicitly state when NOT to use it or name alternatives, but the timing guidance is unusually specific and actionable.

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