BestEOR: EOR pricing and employment costs

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

Annotations already cover the safety profile (readOnly, idempotent, closed-world, non-destructive), so the description's added value is its disclosure of what the comparison yields: published fees, country coverage, owned entities, delivery model, primary sources, and a BestEOR.co link. That sourcing detail is genuine behavioral context beyond the annotations.

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 that puts the verb and comparison dimensions first and appends the sourcing detail. Dense but not padded; every clause maps to a concrete output dimension.

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 output schema and one fully documented parameter, the description compensates by enumerating what comes back (fee, coverage, entities, delivery model, sources, comparison link). An agent can decide whether to call it and what to expect.

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% and the single 'providers' parameter is fully documented (names or slugs, 2-3 items). The description's 'two or three EOR providers' merely restates the schema constraints, adding no syntax or format guidance.

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?

States a specific verb (compare), resource (EOR providers), and enumerates the exact comparison dimensions (published fee, country coverage, owned entities, delivery model). This clearly separates it from siblings like list_eor_providers and get_eor_provider, which retrieve rather than contrast.

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 (comparing two or three providers) but gives no explicit when-to-use guidance relative to estimate_eor_cost or get_eor_provider, and no exclusions. A reader can infer intent from the verb, but the agent is not routed to alternatives.

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 declare readOnlyHint/idempotentHint/non-destructive, so safety is covered. The description adds real behavioral context beyond that: the calculation is an approximation that ignores contribution caps and thresholds, and the fee can come from a published provider rate or a user-supplied quote. It stops short of describing any output structure or edge 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?

Two sentences, front-loaded with the core computation and followed by the essential accuracy caveat. No filler; every clause (cost components, fee source, cap caveat) earns its place.

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 read-only estimation tool with a fully-described schema and no output schema, the description conveys the return shape ('annual and monthly cost') and the accuracy limits. Nearly complete; only the absence of any pointer to related comparison tools leaves a small 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 coverage is 100%, so all six parameters are already documented. The description's mention of 'a provider's published fee, or one you supply from a quote' mirrors the schema's own override note for provider/monthly_fee_usd, adding little beyond what the schema states. Baseline 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?

Specific verb+resource ('estimate the annual and monthly cost of employing people in a country through an EOR') with an explicit breakdown of the computed components (gross salary, employer contribution, EOR fee, other monthly costs). It distinguishes itself functionally from get_country_employment_costs by including the EOR fee, though it never names a sibling tool directly.

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 caveat 'A budget illustration, not a payroll quote: contribution caps and thresholds are not applied' tells the agent when this tool's output is appropriate and when it is not suitable for exact payroll. It does not, however, point to an alternative tool (e.g. compare_eor_providers) for the scenarios it excludes.

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 declare readOnlyHint, idempotentHint, destructiveHint=false and openWorldHint=false, so the safety profile is covered. The description adds non-trivial context beyond that: each statutory term is returned 'with its primary source', which tells the agent the response carries provenance. It stops short of disclosing legal-data freshness, coverage gaps, or error behavior for unknown countries.

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?

Two sentences, both front-loaded: the first defines exactly what is returned, the second defines accepted input formats. Every clause carries information an agent needs, with 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?

With no output schema, the description carries the burden of describing return values, and it does so by enumerating the fields and noting source citations. For a legal/compliance tool it is nearly complete, though it omits what happens for unsupported countries and how current the statutory data is.

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% and the single parameter is already documented as a name, ISO code, or slug, so the baseline is 3. The description adds concrete accepted forms with examples ('Germany', 'BR', 'united-kingdom'), clarifying case/format expectations beyond the schema text.

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 (Get) and precisely enumerates the returned resource: statutory contribution rates, minimum wage, annual leave, notice, severance, probation. This scope is clearly distinguishable from the sibling tools, which concern EOR providers and cost estimates, so an agent can route correctly without opening a schema.

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?

Usage is implied by the content of the returned data (employing someone in a country), but there is no explicit when-to-use statement and no named alternative such as estimate_eor_cost or compare_eor_providers. Nothing is misleading; the guidance is simply inferred rather than stated.

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 declare this a read-only, idempotent, non-destructive, closed-world lookup, so safety needs no restating. The description adds real behavioral context by disclosing that fees may be quote-only rather than published and that every figure carries a primary-source URL.

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?

Two sentences, front-loaded with what is returned before the accepted input forms. The return-field enumeration is long but each element is informative, so little is wasted.

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 output schema, the description carries the return-value burden and does so by naming the data categories returned. The single required parameter is fully documented, though it does not say what happens for an unknown provider name.

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% and the schema already says 'Provider name or slug', so baseline is 3. The description goes beyond it by clarifying that either form is accepted and giving four concrete example values, which is genuine added meaning.

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?

States a specific verb ('Get') and resource ('one EOR provider') and enumerates the returned facets (published fee or quote-only terms, country coverage, owned-entity footprint, delivery model, best-for, source URL). The word 'one' clearly separates it from the list_eor_providers sibling.

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 documents accepted input forms with concrete examples ('Deel', 'oyster-hr'), which is useful, but never says when to choose this over list_eor_providers or compare_eor_providers. Usage is implied by the singular 'one provider' framing rather than stated.

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 establish this as a safe, idempotent, closed-world read. The description goes beyond them by disclosing catalog size (85 providers), the fact that fees may be quote-only, and the non-obvious filter semantics that excluded providers are silently dropped rather than returned with nulls.

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?

Two sentences, front-loaded with the verb and resource; the returned-field list is dense but earns its place since there is no output schema. Slightly run-on, but 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?

With no output schema, the description usefully enumerates return fields, and all six parameters are documented in the schema. Minor gaps remain around result ordering defaults and whether unpriced providers surface at all, but nothing an agent needs to call it is missing.

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 baseline is 3, but the description generalizes the publish-only rule to both max_monthly_fee_usd and min_countries, while the schema only states it for the fee parameter. That clarification exceeds what the structured data provides.

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?

Names a specific verb (list/filter) and resource (the 85 EOR providers tracked by BestEOR.co) and enumerates the fields returned, so an agent can distinguish it from get_eor_provider or compare_eor_providers without opening the schema.

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?

Implies the browse-and-filter use case and adds an important selection rule ('a fee ceiling or coverage minimum only matches providers that publish that figure'), which warns the agent that filtered results are a subset. It never names when to prefer compare_eor_providers or get_eor_provider instead, so routing is left to inference.

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