Skip to main content
Glama
Weichie-com

teamleader-mcp

by Weichie-com

Server Quality Checklist

67%
Profile completionA complete profile improves this server's visibility in search results.
  • Latest release: v1.0.4

  • Disambiguation5/5

    Each tool follows a clear resource+action naming pattern, making purposes distinct. Potential overlaps like deal_move vs deal_update are differentiated by specific semantics. No two tools appear to do the same thing.

    Naming Consistency5/5

    All tools use teamleader_<resource>_<action> consistently. List operations use plural resources while info operations use singular, a predictable pattern. Minor variation like add vs create is contextually appropriate.

    Tool Count2/5

    At 42 tools, the server is heavily oversized, far exceeding the 25+ threshold. Even for a full CRM integration, the number introduces significant context overhead and suggests a lack of consolidation.

    Completeness3/5

    Multiple core entities have missing CRUD operations: contacts lack create/update/delete, events lack update/delete, products lack delete. While many modules are covered, these gaps are notable and will require workarounds.

  • Average 3.4/5 across 42 of 42 tools scored. Lowest: 2.7/5.

    See the Tool Scores section below for per-tool breakdowns.

    • No community issues in the last 6 months
    • 0 commits in the last 12 weeks
    • No stable releases found
    • No critical vulnerability alerts
    • No high-severity vulnerability alerts
    • No code scanning findings
    • CI status not available
  • This repository is licensed under MIT License.

  • This repository includes a README.md file.

  • No tool usage detected in the last 30 days. Usage tracking helps demonstrate server value.

    Tip: use the "Try in Browser" feature on the server page to seed initial usage.

  • Add a glama.json file to provide metadata about your server.

  • If you are the author, simply .

    If the server belongs to an organization, first add glama.json to the root of your repository:

    {
      "$schema": "https://glama.ai/mcp/schemas/server.json",
      "maintainers": [
        "your-github-username"
      ]
    }

    Then . Browse examples.

  • Add related servers to improve discoverability.

How to sync the server with GitHub?

Servers are automatically synced at least once per day, but you can also sync manually at any time to instantly update the server profile.

To manually sync the server, click the "Sync Server" button in the MCP server admin interface.

How is the quality score calculated?

The overall quality score combines two components: Tool Definition Quality (70%) and Server Coherence (30%).

Tool Definition Quality measures how well each tool describes itself to AI agents. Every tool is scored 1–5 across six dimensions: Purpose Clarity (25%), Usage Guidelines (20%), Behavioral Transparency (20%), Parameter Semantics (15%), Conciseness & Structure (10%), and Contextual Completeness (10%). The server-level definition quality score is calculated as 60% mean TDQS + 40% minimum TDQS, so a single poorly described tool pulls the score down.

Server Coherence evaluates how well the tools work together as a set, scoring four dimensions equally: Disambiguation (can agents tell tools apart?), Naming Consistency, Tool Count Appropriateness, and Completeness (are there gaps in the tool surface?).

Tiers are derived from the overall score: A (≥3.5), B (≥3.0), C (≥2.0), D (≥1.0), F (<1.0). B and above is considered passing.

Tool Scores

  • Behavior1/5

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

    The description only states 'Delete', which is already implied by the tool name. With no annotations provided, the description carries full burden to disclose behavioral traits such as permanence, cascading effects, or error behavior. It fails to communicate whether deletion is irrevocable or what happens if the entry does not exist, making it insufficiently transparent for a destructive action.

    Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

    Conciseness5/5

    Is the description appropriately sized, front-loaded, and free of redundancy?

    The description is a single, direct sentence with no filler. It is well-structured and front-loaded, earning a perfect score for conciseness.

    Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

    Completeness2/5

    Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

    Although the tool is simple, it is destructive and lacks any annotation or output schema. The description does not explain what will happen after deletion, whether it affects other records, or what the response will be. This leaves significant gaps for an agent to safely use the tool, especially when compared to the completeness expected of a mutation tool.

    Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

    Parameters3/5

    Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

    Schema coverage is 100% for the single 'id' parameter, which is described as 'Time tracking UUID'. The description adds no additional parameter meaning, but the schema already fully documents it, so a baseline of 3 is appropriate.

    Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

    Purpose4/5

    Does the description clearly state what the tool does and how it differs from similar tools?

    The description clearly states the action ('Delete') and the resource ('a time tracking entry'), making it unambiguous. It distinguishes from sibling tools by being the only delete operation in the timetracking family, but it doesn't explicitly mention any scope or conditions, so it's slightly less informative than a top-tier purpose statement.

    Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

    Usage Guidelines2/5

    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 vs alternatives like timetracking_update or timetracking_add. There is no mention of prerequisites, conditions, or what warrants a deletion, leaving the agent without explicit usage context.

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

  • Behavior1/5

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

    Annotations are absent, so the description must carry the full burden of behavioral disclosure. However, it merely restates the tool name without mentioning side effects, reversibility, or any impact on related entities. This is essentially tautological.

    Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

    Conciseness4/5

    Is the description appropriately sized, front-loaded, and free of redundancy?

    The description is a single, clear sentence with no fluff. It is appropriately short for the simple action, but it is minimal to the point of omitting useful context.

    Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

    Completeness2/5

    Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

    With only one parameter and no output schema, the description should explain workflow prerequisites or return behavior. It only states the basic action, leaving the agent uninformed about when to accept a quotation or what happens after acceptance.

    Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

    Parameters3/5

    Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

    The schema fully covers the only parameter (id) with the description 'Quotation UUID', so the tool description adds no extra meaning. 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.

    Purpose5/5

    Does the description clearly state what the tool does and how it differs from similar tools?

    The description 'Mark a quotation as accepted' clearly states the action (mark), the resource (quotation), and the resulting state (accepted). This distinguishes it from sibling tools like send, delete, or update.

    Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

    Usage Guidelines2/5

    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, such as prerequisites (e.g., quotation must be sent first) or how it fits into the quotation workflow. The description simply states the action without any contextual guidance.

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

  • Behavior2/5

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

    With no annotations provided, the description must carry the full burden of behavioral transparency. It only says 'update' without disclosing whether this is a partial or full replacement, whether it triggers side effects like notifications, or whether certain fields are immutable. This is insufficient for a mutation tool.

    Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

    Conciseness4/5

    Is the description appropriately sized, front-loaded, and free of redundancy?

    The description is a single, clear sentence with no extraneous words, making it highly concise. However, its brevity borders on under-specification, as it omits any mention of the parameters or operational nuances that could aid the agent.

    Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

    Completeness2/5

    Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

    Given the tool's 6 parameters, nested objects, and lack of output schema or annotations, the description is too sparse to be fully contextually complete. It fails to explain return behavior, idempotency, or the nature of the update, leaving significant gaps for the agent to guess.

    Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

    Parameters3/5

    Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

    The input schema includes descriptions for all six parameters, achieving 100% coverage. The description itself adds no extra meaning beyond what the schema already states, so the baseline of 3 applies.

    Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

    Purpose4/5

    Does the description clearly state what the tool does and how it differs from similar tools?

    The description 'Update an existing quotation in Teamleader Focus' clearly identifies the verb (update) and resource (quotation), distinguishing it from sibling tools like create or send. However, it offers no additional detail about which fields are affected, leaving the purpose slightly less specific than the schema could support.

    Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

    Usage Guidelines2/5

    Does the description explain when to use this tool, when not to, or what alternatives exist?

    The description provides no guidance on when to use this tool versus alternatives like teamleader_quotation_create or teamleader_quotation_send. The only implied context is that the quotation must already exist, but there is no explicit 'use when' or 'use instead' direction.

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

  • Behavior1/5

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

    There are no annotations, so the description must disclose behavioral traits. It only repeats the action implied by the name and does not mention side effects, permissions, or required context. It adds no behavioral information beyond the tool's name.

    Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

    Conciseness5/5

    Is the description appropriately sized, front-loaded, and free of redundancy?

    The description is a single concise sentence with no unnecessary words. It is front-loaded and easy to parse, earning its place without fluff.

    Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

    Completeness2/5

    Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

    Given the tool has 7 parameters and no output schema, the description is too sparse. It does not explain return values, constraints, or how to select the right subject_type. The schema covers parameter formats, but the description lacks overall context.

    Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

    Parameters3/5

    Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

    The input schema provides descriptions for all 7 parameters (100% coverage), so the description does not need to explain parameters. The description adds nothing beyond the schema, so baseline 3 is appropriate.

    Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

    Purpose5/5

    Does the description clearly state what the tool does and how it differs from similar tools?

    The description clearly states the tool adds a new time tracking entry, which is a specific action on a specific resource. It distinguishes from sibling tools like teamleader_timetracking_update and teamleader_timetracking_delete.

    Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

    Usage Guidelines2/5

    Does the description explain when to use this tool, when not to, or what alternatives exist?

    The description provides no guidance on when to use this tool versus alternatives. It does not mention use cases, prerequisites, or exclude scenarios.

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

  • Behavior2/5

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

    No annotations are provided, so the description carries the full burden of behavioral disclosure. It only states 'List companies' and filter options, which implies a read-only operation but does not disclose pagination, response format, data scope (e.g., all companies vs. active only), or authentication requirements. This is insufficient for a list tool with no annotations.

    Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

    Conciseness5/5

    Is the description appropriately sized, front-loaded, and free of redundancy?

    The description is two sentences with no fluff: 'List companies from Teamleader Focus. Can filter by name, VAT number, or tags.' It is concise, front-loaded with the primary action, and every word earns its place.

    Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

    Completeness3/5

    Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

    With 5 parameters, no required fields, no output schema, and no annotations, the description is minimally adequate. It explains the core function and filter capability, but lacks details about return values, pagination, or any limits. For a list tool with no output schema, more context would be valuable, though the tool is relatively simple.

    Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

    Parameters3/5

    Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

    The schema covers 100% of parameters with descriptions, so the baseline is 3. The description adds a conceptual summary by mentioning 'name, VAT number, or tags', but this slightly misrepresents the 'term' parameter which searches more than just name. It does not add meaningful detail beyond the schema's parameter descriptions.

    Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

    Purpose4/5

    Does the description clearly state what the tool does and how it differs from similar tools?

    The description clearly states 'List companies from Teamleader Focus', which is a specific verb and resource. It distinguishes from sibling tools like teamleader_contacts_list and teamleader_deals_list by focusing on companies. However, it does not explicitly differentiate from teamleader_company_info, which retrieves a single company, but the 'list' context makes this implicitly clear.

    Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

    Usage Guidelines2/5

    Does the description explain when to use this tool, when not to, or what alternatives exist?

    The description provides no guidance on when to use this tool versus alternatives. It simply says 'List companies' and mentions filters, which is implied usage, but there is no information about prerequisites, when to prefer this over company_info, or any exclusions. With multiple list and info sibling tools, the lack of explicit usage context reduces utility.

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

  • Behavior2/5

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

    With no annotations provided, the description carries the full burden of behavioral disclosure. It only states the action 'Mark a deal as lost' without explaining consequences such as irreversibility, required deal state, or side effects like closing the deal or triggering notifications. This is a significant gap for a state-changing operation.

    Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

    Conciseness4/5

    Is the description appropriately sized, front-loaded, and free of redundancy?

    The description is a single, efficient sentence with no wasted words. It is highly concise and front-loaded, but lacks any structural expansion (e.g., caveats or examples) that would improve usefulness while still remaining concise.

    Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

    Completeness2/5

    Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

    Despite the tool's low complexity, the description is insufficient. It omits behavioral context such as whether the action is reversible, whether a reason is recommended, and how this differs from dealing with a won deal. Given no output schema and no annotations, the description alone is too sparse for an agent to fully understand the operation's implications.

    Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

    Parameters3/5

    Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

    The input schema already provides descriptions for all three parameters (id, reason_id, extra_info) with 100% coverage. The tool description adds no additional parameter details, so the baseline of 3 is appropriate. The parameter meanings are clear from the schema alone.

    Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

    Purpose5/5

    Does the description clearly state what the tool does and how it differs from similar tools?

    The description 'Mark a deal as lost' uses a specific verb ('mark') and resource ('deal') with a clear outcome ('as lost'), unambiguously distinguishing it from sibling tools like teamleader_deal_win and teamleader_deal_update. It is concise and directly states the tool's purpose.

    Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

    Usage Guidelines2/5

    Does the description explain when to use this tool, when not to, or what alternatives exist?

    The description provides no guidance on when to use this tool versus alternatives. It does not mention prerequisites (e.g., the deal must be open) or contrast with teamleader_deal_win or teamleader_deal_update, leaving usage context entirely to the name and user inference.

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

  • Behavior2/5

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

    No annotations are supplied, so the description bears full responsibility for behavioral disclosure. It only says 'create', implying a mutation operation, but does not detail permissions, side effects, reversibility, or what happens upon creation. This transparency gap is significant for a tool with no annotations.

    Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

    Conciseness5/5

    Is the description appropriately sized, front-loaded, and free of redundancy?

    The description is a single, focused sentence with no wasted words. It is front-loaded and appropriately sized for the tool's straightforward action, earning full marks for conciseness.

    Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

    Completeness1/5

    Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

    The tool has 7 parameters, 5 required, no annotations, and no output schema. The one-sentence description does nothing to explain the context of creating a draft invoice, such as the meaning of grouped_lines, payment term types, or the relationship with customers and departments. This is severely incomplete for such a complex tool.

    Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

    Parameters3/5

    Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

    The input schema provides descriptions for 86% of parameters (6 out of 7), so the schema carries most of the semantic load. The description adds no parameter-specific information, which aligns with the baseline for high schema coverage.

    Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

    Purpose5/5

    Does the description clearly state what the tool does and how it differs from similar tools?

    Description clearly states 'Create a new draft invoice in Teamleader Focus', using a specific verb and resource. It distinguishes itself from sibling tools like teamleader_invoice_send, teamleader_invoice_book, and teamleader_invoice_delete by focusing specifically on draft creation.

    Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

    Usage Guidelines2/5

    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. It does not mention prerequisites, such as needing an existing customer or department, nor does it reference related tools like quotations or other invoice actions.

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

  • Behavior2/5

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

    With no annotations, the description carries the full burden of behavioral disclosure. It only says 'List products' and does not mention return format, pagination, read-only nature, auth requirements, or any side effects, which is insufficient for a tool with zero annotation coverage.

    Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

    Conciseness5/5

    Is the description appropriately sized, front-loaded, and free of redundancy?

    The description is a single clear sentence with no wasted words. It is front-loaded with the key verb and resource, and every word contributes to the meaning.

    Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

    Completeness3/5

    Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

    The tool is simple (2 optional params, no output schema), so the description conveys the basic function. However, it lacks any mention of what the response contains, pagination limits, or how filtering works, which is necessary given the absence of an output schema.

    Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

    Parameters3/5

    Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

    The schema fully describes both parameters (term and updated_since) with meaningful descriptions, so the baseline is 3. The tool description adds no additional parameter context, but the schema already covers the semantics.

    Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

    Purpose4/5

    Does the description clearly state what the tool does and how it differs from similar tools?

    The description clearly states the action ('List') and the resource ('products'), identifying the core purpose. However, it does not differentiate this tool from sibling tools like teamleader_product_info, which may also retrieve product data.

    Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

    Usage Guidelines2/5

    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. The description gives no context for filtering, comparing with product_info, or any exclusions, leaving the agent to infer usage solely from the name.

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

  • Behavior2/5

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

    With no annotations, the description must fully disclose behavior, but it only states the basic action. It doesn't mention whether the update is partial or full, error handling, permission requirements, or return values, leaving significant ambiguity for a mutation tool.

    Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

    Conciseness4/5

    Is the description appropriately sized, front-loaded, and free of redundancy?

    The description is a single sentence that is concise and front-loaded with the core action. However, it's arguably too brief for a tool with five parameters, though it does not waste words.

    Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

    Completeness2/5

    Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

    For a mutation tool with no annotations and no output schema, the description is insufficiently complete. It lacks context on usage scenarios, what fields are updatable (beyond schema), and what happens on execution, making it inadequate for an agent to fully understand the tool's behavior.

    Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

    Parameters3/5

    Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

    The input schema already provides 100% description coverage for all five parameters, so the description doesn't need to add parameter semantics. It adds no additional meaning beyond the schema, giving the baseline score of 3.

    Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

    Purpose5/5

    Does the description clearly state what the tool does and how it differs from similar tools?

    The description uses the explicit verb 'Update' with resource 'existing product' and system 'Teamleader Focus', clearly distinguishing it from sibling tools like teamleader_product_create and teamleader_product_info. The purpose is unambiguous.

    Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

    Usage Guidelines2/5

    Does the description explain when to use this tool, when not to, or what alternatives exist?

    The description provides no guidance on when to use this tool versus alternatives such as teamleader_product_create for new products or other update tools. There is no mention of prerequisites, context, or exclusions.

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

  • Behavior2/5

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

    No annotations are provided, so the description must disclose behavioral traits. It only says 'Create' without explaining side effects, permissions, irreversibility, or what the response contains. For a create action, this is minimal but lacks depth about the created resource's state.

    Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

    Conciseness4/5

    Is the description appropriately sized, front-loaded, and free of redundancy?

    The description is a single, clear sentence with no wasted words. It is front-loaded with the action and resource. However, its brevity leaves room for more helpful context, so it's not a perfect 5.

    Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

    Completeness2/5

    Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

    Given the tool's complexity (6 params, nested objects, no output schema), the description is too sparse. It does not explain the implication of creating a quotation, how grouped_lines or expiry work in practice, or what happens after creation. The schema descriptions help, but the tool-level context is missing.

    Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

    Parameters3/5

    Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

    Schema description coverage is 100%, so all parameters are already documented with their types and descriptions. The tool description adds no additional parameter meaning, so the baseline of 3 applies.

    Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

    Purpose5/5

    Does the description clearly state what the tool does and how it differs from similar tools?

    The description clearly states the action ('Create') and the resource ('a new quotation'), specifying the system ('Teamleader Focus'). It is unambiguous and distinguishes this tool from siblings like teamleader_quotation_update or teamleader_quotation_send.

    Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

    Usage Guidelines2/5

    Does the description explain when to use this tool, when not to, or what alternatives exist?

    The description provides no guidance on when to use this tool versus alternatives, nor any prerequisites or context. While the name implies creation, there is no mention of required dependencies (e.g., needing a deal_id) or exclusions.

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

  • Behavior2/5

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

    With no annotations provided, the description carries the full burden of behavioral disclosure, but it only states the tool lists quotations. It does not mention pagination, ordering, field selection, whether only IDs are returned, or any other behavioral traits that would help an agent understand the tool's output or side effects.

    Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

    Conciseness5/5

    Is the description appropriately sized, front-loaded, and free of redundancy?

    The description is a single, front-loaded sentence with no filler words. Every word contributes to the purpose, and it is appropriately sized for a simple list tool.

    Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

    Completeness3/5

    Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

    Given the tool's low complexity (one optional parameter, no output schema), the description is adequate but leaves gaps. It does not explain what the listed quotations contain, whether the list is paginated, or how the 'ids' filter affects the results. Still, for a straightforward list operation, it meets the minimum viable threshold.

    Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

    Parameters3/5

    Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

    The input schema defines one parameter 'ids' with description 'Filter by UUIDs', giving 100% schema description coverage. The tool description itself adds no additional parameter semantics beyond the schema, so the baseline of 3 is appropriate.

    Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

    Purpose4/5

    Does the description clearly state what the tool does and how it differs from similar tools?

    The description clearly states the action ('List') and the resource ('quotations'), and it names the system ('Teamleader Focus'). However, it does not explicitly differentiate from sibling tools like teamleader_quotation_info or teamleader_quotation_create, though the verb 'list' implies a collection operation.

    Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

    Usage Guidelines2/5

    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, nor on the intended use of the optional 'ids' filter. The description implies a basic listing use case but does not mention exclusions, prerequisites, or scenarios where other quotation tools would be more appropriate.

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

  • Behavior2/5

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

    With no annotations provided, the description carries full burden but only states 'Update an existing company.' It does not disclose side effects, required permissions, overwriting behavior, or any other behavioral traits.

    Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

    Conciseness5/5

    Is the description appropriately sized, front-loaded, and free of redundancy?

    The description is a single sentence, perfectly concise and front-loaded, with no wasted words.

    Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

    Completeness2/5

    Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

    The tool has four parameters and no output schema, but the description is too sparse to provide complete context. It does not explain update semantics, optionality, or what happens if fields are omitted.

    Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

    Parameters3/5

    Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

    Schema description coverage is 100%, so each parameter is already documented. The description adds no additional semantic value beyond the schema.

    Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

    Purpose5/5

    Does the description clearly state what the tool does and how it differs from similar tools?

    The description 'Update an existing company' uses a specific verb and resource, and clearly distinguishes the tool from sibling tools like teamleader_company_create and teamleader_company_info.

    Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

    Usage Guidelines2/5

    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 exclusions.

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

  • Behavior2/5

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

    With no annotations, the description carries the full burden of behavioral disclosure, but it only restates the action 'Create a new deal/opportunity'. It does not mention permissions, side effects, or what happens after creation, offering no additional context beyond the tool's name.

    Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

    Conciseness4/5

    Is the description appropriately sized, front-loaded, and free of redundancy?

    The description is a single concise sentence with no wasted words. However, it is somewhat redundant with the tool name, adding minimal value. It is appropriately sized but could be slightly more informative without becoming verbose.

    Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

    Completeness3/5

    Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

    Given the tool is a simple CRUD create operation with a fully documented schema, the description covers the basic purpose. However, it lacks information about return values, error potentials, or required authorizations, which would be helpful for an agent operating without annotations or an output schema.

    Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

    Parameters3/5

    Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

    The input schema provides 100% coverage for all 9 parameters, including descriptions for each. The description itself contributes no parameter-specific information, but since the schema is fully descriptive, baseline 3 is appropriate.

    Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

    Purpose5/5

    Does the description clearly state what the tool does and how it differs from similar tools?

    The description uses a specific verb 'Create' with a clear resource 'deal/opportunity', making the tool's purpose unmistakable. It also distinguishes from sibling tools like deal_update or deal_move by clearly indicating this is for creating new deals.

    Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

    Usage Guidelines2/5

    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. The description only states what the tool does, without mentioning scenarios, prerequisites, or explicitly contrasting with related tools such as teamleader_deal_update.

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

  • Behavior2/5

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

    With no annotations, the description carries the full burden of behavioral disclosure. It only repeats the action 'update' without explaining whether it is a partial or full update, what permissions are required, whether the updated deal is returned, or how errors are surfaced. This is insufficient for a mutation tool.

    Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

    Conciseness5/5

    Is the description appropriately sized, front-loaded, and free of redundancy?

    The description is a single, front-loaded sentence with no unnecessary words. It earns its place by stating the core purpose efficiently.

    Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

    Completeness2/5

    Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

    The tool has no annotations and no output schema, yet the description provides no context about update semantics, return values, validation, or side effects. It only restates the obvious, leaving the agent without enough context to reliably predict behavior for a write operation.

    Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

    Parameters3/5

    Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

    Schema description coverage is 100%, so the baseline is 3. The description itself adds no parameter semantics, but the schema fully documents each parameter, so no further compensation is needed.

    Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

    Purpose5/5

    Does the description clearly state what the tool does and how it differs from similar tools?

    The description 'Update an existing deal in Teamleader Focus.' clearly states the verb (update) and resource (deal), and the word 'existing' distinguishes it from creation tools like teamleader_deal_create and from lifecycle tools like win/lose/move.

    Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

    Usage Guidelines2/5

    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 other deal operations such as move, win, or lose. There is no mention of alternatives, prerequisites, or exclusions, leaving the agent to infer appropriate use from the name alone.

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

  • Behavior2/5

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

    With no annotations, the description must disclose behavioral traits. It only states the action without side effects, idempotency, currency implications, or state changes. For a mutation tool, this is insufficient.

    Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

    Conciseness5/5

    Is the description appropriately sized, front-loaded, and free of redundancy?

    The description is a single, clear sentence with no redundant words. It's appropriately front-loaded.

    Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

    Completeness2/5

    Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

    Given no output schema and no annotations, the description is too minimal to provide a complete picture. It doesn't explain return values, error conditions, or the impact on invoice status, making it insufficient for a payment-registration tool.

    Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

    Parameters3/5

    Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

    All four parameters are described in the input schema (100% coverage), so the description doesn't need to add parameter details. The description itself adds nothing beyond the schema, but that's acceptable given high schema coverage.

    Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

    Purpose5/5

    Does the description clearly state what the tool does and how it differs from similar tools?

    The description uses a specific verb 'Register' and names the resource 'a payment for an invoice', clearly distinguishing it from sibling tools like teamleader_invoice_send or teamleader_invoice_book.

    Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

    Usage Guidelines2/5

    Does the description explain when to use this tool, when not to, or what alternatives exist?

    No usage context is provided; there's no mention of when to use this tool versus alternatives, prerequisites, or exclusions. It's merely an imperative statement.

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

  • Behavior2/5

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

    With no annotations provided, the description carries the full burden of behavioral disclosure. It only states the primary action (sending via email) and does not reveal side effects like status changes, the generation of cloud sign links, email delivery behavior, or potential failures. This is a significant lack of transparency for a mutating action.

    Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

    Conciseness5/5

    Is the description appropriately sized, front-loaded, and free of redundancy?

    The description is a single, direct sentence with no filler words. It is concise and immediately front-loaded with the core action.

    Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

    Completeness2/5

    Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

    The tool has five required parameters, no output schema, and no annotations, yet the description is only one sentence. It does not explain the full workflow (e.g., how to use the #LINK placeholder for the cloud sign URL, whether sending updates the quotation status, or what the agent should expect in return). This is insufficient for a complex action that sends emails.

    Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

    Parameters3/5

    Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

    The input schema has 100% description coverage for all five parameters, so the schema already provides complete parameter semantics. The tool description adds no additional parameter-level detail, earning a baseline 3.

    Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

    Purpose5/5

    Does the description clearly state what the tool does and how it differs from similar tools?

    The description clearly states the action: 'Send a quotation via email.' It uses a specific verb ('Send') and resource ('quotation'), and the email medium is explicit. This distinguishes it from siblings like quotation_accept or quotation_download.

    Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

    Usage Guidelines2/5

    Does the description explain when to use this tool, when not to, or what alternatives exist?

    The description gives no guidance on when to use this tool versus alternatives such as teamleader_invoice_send or teamleader_quotation_accept. There is no mention of prerequisites, context, or exclusions, leaving the agent without decision support.

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

  • Behavior2/5

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

    Annotations are absent, so the description must carry the behavioral disclosure burden. It fails to disclose whether the update is partial or full, what happens if the ID is invalid, or any permission requirements. This is a significant gap for a mutation tool.

    Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

    Conciseness5/5

    Is the description appropriately sized, front-loaded, and free of redundancy?

    The description is a single, clear sentence that immediately communicates the tool's purpose. There is no wasted text, and the structure is front-loaded with the action.

    Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

    Completeness2/5

    Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

    For a mutation tool with no annotations and no output schema, this description is under-specified. It lacks any context about behavior, return values, or prerequisites, leaving the agent to infer important operational details.

    Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

    Parameters3/5

    Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

    The input schema fully documents all three parameters with descriptions, so the description adds no additional parameter semantics. The baseline score of 3 is appropriate because the schema does the heavy lifting.

    Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

    Purpose5/5

    Does the description clearly state what the tool does and how it differs from similar tools?

    The description clearly states the action ('Update') and resource ('existing time tracking entry'), distinguishing it from sibling tools like add, delete, list, and info. The scope of 'existing' is explicit and appropriate.

    Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

    Usage Guidelines2/5

    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. It does not mention that this is for modifying existing entries only, nor does it reference the add or delete siblings, leaving the agent without decision support.

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

  • Behavior2/5

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

    No annotations are provided, so the description carries the full burden for behavioral disclosure. It does not explicitly state that the operation is read-only, describe any pagination or limits, or mention potential side effects. The filter list is also slightly inaccurate (says 'company' instead of 'company_id' and omits 'status'), reducing transparency.

    Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

    Conciseness5/5

    Is the description appropriately sized, front-loaded, and free of redundancy?

    A single clear sentence that front-loads the core purpose and then lists filter capabilities. No wasted words, and the structure is easy to scan.

    Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

    Completeness3/5

    Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

    The description is adequate for a simple list tool with four optional parameters, but it lacks information about pagination, result ordering, or the absence of an output schema. It also fails to mention the 'status' filter, which is in the schema. Overall, it covers the essentials but leaves gaps.

    Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

    Parameters3/5

    Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

    Schema coverage is 100%, so the baseline is 3. The description's list of filters ('name, email, company, or tags') loosely maps to the schema but omits 'status' and uses 'company' instead of 'company_id', which could mislead. It does not add meaningful parameter semantics beyond the schema.

    Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

    Purpose4/5

    Does the description clearly state what the tool does and how it differs from similar tools?

    The description clearly states the verb 'List' and the resource 'contacts from Teamleader Focus', making the core purpose obvious. It does not explicitly distinguish itself from sibling tools like teamleader_contact_info, but the plural action and filter options imply a collection query.

    Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

    Usage Guidelines3/5

    Does the description explain when to use this tool, when not to, or what alternatives exist?

    The description implies use when a list of contacts is needed, and mentions filter options. However, it does not provide explicit when-to-use vs. alternatives, mention that all parameters are optional, or exclude cases where contact_info would be more appropriate.

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

  • Behavior2/5

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

    There are no annotations, so the description must disclose behavioral traits. It only states the action without explaining side effects (e.g., whether invoice status changes to 'sent', email deliverability, or idempotency). This is minimal behavioral disclosure.

    Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

    Conciseness5/5

    Is the description appropriately sized, front-loaded, and free of redundancy?

    The description is a single concise sentence with no redundancy or irrelevant details. It is appropriately sized for the tool's simplicity.

    Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

    Completeness3/5

    Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

    For a simple email-sending tool, the schema covers all parameters, but the description omits context about invoice state requirements (e.g., must be booked) and post-send effects. It meets the minimum viability but lacks helpful context for a tool with sibling operations.

    Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

    Parameters3/5

    Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

    The input schema covers all 4 parameters with clear descriptions (id, to, body, subject), so the description doesn't need to add param meaning. Baseline of 3 applies; the description adds no extra parameter semantics.

    Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

    Purpose5/5

    Does the description clearly state what the tool does and how it differs from similar tools?

    The description uses a specific verb ('Send') and resource ('invoice') plus medium ('via email'), clearly distinguishing it from other invoice tools like draft, book, or delete. It unambiguously states the tool's function.

    Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

    Usage Guidelines2/5

    Does the description explain when to use this tool, when not to, or what alternatives exist?

    No guidance is provided about when to use this tool versus alternatives such as teamleader_invoice_draft or teamleader_invoice_book. It lacks prerequisites (e.g., invoice must be booked) or context about email sending rules.

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

  • Behavior2/5

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

    With no annotations, the description carries full responsibility for behavioral disclosure. It only states the action without indicating whether deletion is permanent, has status restrictions, or affects associated data. 'Delete' implies destruction but lacks specific context.

    Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

    Conciseness5/5

    Is the description appropriately sized, front-loaded, and free of redundancy?

    The description is a single, direct sentence ('Delete a quotation.') that is immediately clear and free of unnecessary words. It is appropriately concise for a simple deletion operation.

    Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

    Completeness3/5

    Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

    The tool has low complexity (one parameter, no output schema) and the schema is complete. However, the description omits any mention of return values, error behavior, or whether deletion is conditional on quotation status, leaving some ambiguity for an agent.

    Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

    Parameters3/5

    Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

    The schema has one parameter 'id' with description 'Quotation UUID' (100% coverage). The description adds no parameter-level detail, so it does not enhance understanding beyond the schema; baseline of 3 is appropriate.

    Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

    Purpose5/5

    Does the description clearly state what the tool does and how it differs from similar tools?

    The description uses a specific verb ('Delete') and resource ('quotation'), clearly stating the tool's primary function. It is distinguishable from sibling quotation tools (list, create, update, send, accept, download), making this the deletion operation.

    Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

    Usage Guidelines2/5

    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, such as prerequisites (e.g., only draft/sent quotations) or when deletion is not allowed. The description gives no context for decision-making.

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

  • Behavior2/5

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

    No annotations are provided, so the description bears the full burden of disclosing behavior. It only says 'List time tracking entries' with no mention of pagination, return format, sorting, read-only nature, or any side effects. The description adds no behavioral context beyond what the name already implies.

    Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

    Conciseness4/5

    Is the description appropriately sized, front-loaded, and free of redundancy?

    The description is a single, front-loaded sentence: 'List time tracking entries from Teamleader Focus.' It is concise and contains no fluff. Yet it is slightly under-specified—it could include a brief note about filters or return behavior without being verbose—so it does not quite merit a 5.

    Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

    Completeness2/5

    Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

    With five optional parameters, no output schema, and no annotations, the description should at least clarify what the tool returns (e.g., all matching entries, chronological order, pagination). The one-line description provides none of that context, making it incomplete for an agent that needs to anticipate results or handle large datasets.

    Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

    Parameters3/5

    Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

    The input schema provides complete descriptions for all parameters (100% coverage), including filter semantics like 'Filter by user UUID' and 'Filter by start date (ISO 8601)'. The tool description itself adds no additional parameter meaning, so it is at the baseline for high schema coverage.

    Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

    Purpose5/5

    Does the description clearly state what the tool does and how it differs from similar tools?

    The description clearly states the tool's function: 'List time tracking entries from Teamleader Focus.' It uses a specific verb (list) and resource (time tracking entries), and distinguishes itself from sibling tools like teamleader_timetracking_info (which likely fetches a single entry) and teamleader_timetracking_add (which creates entries).

    Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

    Usage Guidelines3/5

    Does the description explain when to use this tool, when not to, or what alternatives exist?

    The description implies usage: use this when you need to list time tracking entries. However, it provides no explicit guidance on when to use this over alternatives, no mention of the optional filters, and no exclusions or prerequisites. The one-sentence description does not offer any comparison to sibling tools, so usage is only implicitly conveyed.

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

  • Behavior2/5

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

    With no annotations, the description carries the full burden of disclosing behavior. It states only that it creates an event, but omits important behavioral details such as the potential requirement for activity_type_id in some setups, permission requirements, or whether linked deals/contacts are updated. The description adds minimal value beyond the name.

    Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

    Conciseness5/5

    Is the description appropriately sized, front-loaded, and free of redundancy?

    The description is a single, correctly front-loaded sentence with no filler or redundancy. Every word contributes to the meaning.

    Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

    Completeness2/5

    Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

    Given the tool has 10 parameters, no output schema, and no annotations, the description is too sparse. It does not mention the requirement of activity_type_id in some setups, nor does it clarify how the created event relates to linked resources (contacts, companies, deals) or what response to expect. The schema covers parameter semantics but not usage context.

    Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

    Parameters3/5

    Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

    Schema description coverage is 100%, so the description does not need to explain parameters. The description adds no extra meaning beyond the schema, which is sufficient. Baseline 3 is appropriate.

    Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

    Purpose5/5

    Does the description clearly state what the tool does and how it differs from similar tools?

    The description uses a specific verb ('Create') and resource ('new calendar event') with the platform ('Teamleader Focus'), clearly distinguishing it from event list/info/update tools. There is no ambiguity about what the tool does.

    Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

    Usage Guidelines3/5

    Does the description explain when to use this tool, when not to, or what alternatives exist?

    The description implies use when a new calendar event must be created, but it provides no explicit guidance on when to use this tool versus siblings like teamleader_event_info or teamleader_events_list. No exclusions or alternative recommendations are given.

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

  • Behavior2/5

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

    There are no annotations, so the description carries the full burden of behavioral disclosure. It only states the purpose and does not reveal side effects, required permissions, or return behavior. This is minimal and lacks any useful context beyond the action itself.

    Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

    Conciseness5/5

    Is the description appropriately sized, front-loaded, and free of redundancy?

    The description is a single, direct sentence that is front-loaded and contains no unnecessary words. It is appropriately sized for a simple create operation.

    Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

    Completeness3/5

    Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

    The description is minimal but combined with a well-covered schema, it is adequate for a standard create operation. However, it does not mention return values or any prerequisites, leaving some gaps for an agent.

    Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

    Parameters3/5

    Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

    The input schema has 100% description coverage, with each parameter having a clear description. The tool description adds no parameter information, but the baseline of 3 is appropriate because the schema fully documents the parameters.

    Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

    Purpose5/5

    Does the description clearly state what the tool does and how it differs from similar tools?

    The description states a specific action and resource: 'Create a new company in Teamleader Focus.' This clearly distinguishes it from sibling tools like teamleader_company_update and teamleader_companies_list, which handle different operations on companies.

    Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

    Usage Guidelines3/5

    Does the description explain when to use this tool, when not to, or what alternatives exist?

    The description does not explicitly state when to use this tool or mention alternatives, but the verb 'create' and resource 'company' imply the usage context. No exclusions or alternative suggestions are provided, making it adequate but not fully guiding.

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

  • Behavior2/5

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

    No annotations are provided, so the description carries the full burden. It states 'Get details' which implies a read-only operation, but it does not disclose permission requirements, return format, or error behavior. For a tool with no output schema, this absence of behavioral context is a notable gap.

    Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

    Conciseness5/5

    Is the description appropriately sized, front-loaded, and free of redundancy?

    The description is a single, front-loaded sentence with no wasted words. It efficiently conveys the tool's purpose and required input.

    Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

    Completeness3/5

    Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

    For a simple single-parameter getter with no output schema or annotations, the description is minimally viable but incomplete. It does not specify what the returned 'details' include, nor does it mention potential error cases. It is sufficient for basic use but lacks richer context.

    Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

    Parameters3/5

    Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

    Schema description coverage is 100% - the parameter 'id' is described as 'Company UUID' in the schema. The tool description adds no additional semantic meaning beyond the schema, so baseline 3 is appropriate.

    Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

    Purpose5/5

    Does the description clearly state what the tool does and how it differs from similar tools?

    The description clearly states the action (Get) and resource (details of a specific company) and scope (by ID). It distinguishes from sibling tools like teamleader_companies_list (which lists companies) and teamleader_company_create/update (which modify companies) by focusing on retrieval of a single entity.

    Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

    Usage Guidelines3/5

    Does the description explain when to use this tool, when not to, or what alternatives exist?

    The description implies the tool is used when you have a company ID and need its details, but it does not explicitly state when to use this tool vs alternatives, nor does it mention any exclusions or prerequisites. This is implied usage rather than clear guidance.

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

  • Behavior2/5

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

    With no annotations provided, the description carries the full burden of behavioral disclosure. It simply states the action without revealing side effects, required permissions, reversibility, or response format. For a mutating operation, this is a significant gap.

    Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

    Conciseness5/5

    Is the description appropriately sized, front-loaded, and free of redundancy?

    The description is a single sentence, front-loaded with the action, and contains no filler. It is appropriately concise for a simple operation.

    Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

    Completeness3/5

    Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

    The tool has a simple operation, complete schema coverage, and no output schema, but the absence of annotations and behavioral details leaves gaps. The description adequately states the action but omits context about validation, success/failure behavior, or post-conditions, making it minimally complete rather than fully informative.

    Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

    Parameters3/5

    Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

    Schema description coverage is 100% with both parameters having descriptive names ('Deal UUID' and 'Target phase UUID'). The description adds no additional parameter context, but the schema already provides sufficient meaning, keeping the score at the baseline of 3.

    Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

    Purpose5/5

    Does the description clearly state what the tool does and how it differs from similar tools?

    The description uses a specific verb and resource ('Move a deal to a different phase') that clearly conveys the tool's function. It distinguishes itself from sibling tools like deal_win and deal_lose, which are specific phase transitions, and deal_update, which modifies other deal attributes.

    Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

    Usage Guidelines3/5

    Does the description explain when to use this tool, when not to, or what alternatives exist?

    The description implies when to use the tool (when changing a deal's phase) but does not provide explicit guidance on alternatives or exclusions. No mention is made of using deal_update for other modifications or deal_win/lose for specific outcomes, leaving the agent to infer usage from the tool name and context.

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

  • Behavior2/5

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

    No annotations are available, so the description carries the full burden of behavioral disclosure. It only states that deals can be listed and filtered; it does not mention pagination, result shape, ordering, or whether filters combine in a specific way. This leaves significant behavioral details undisclosed.

    Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

    Conciseness5/5

    Is the description appropriately sized, front-loaded, and free of redundancy?

    The description is two short sentences, front-loaded with the core purpose, and contains no redundant information. Every word earns its place.

    Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

    Completeness3/5

    Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

    For a list tool with six optional parameters and no output schema, the description is minimally adequate but leaves gaps: no mention of result size, pagination, or how filters interact. It covers the basic purpose and filters but lacks the behavioral context needed for full completeness.

    Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

    Parameters3/5

    Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

    Schema description coverage is 100%, and the description merely repeats three filter names already present in the schema. It adds no additional semantic context beyond what the schema's parameter descriptions already provide, so baseline 3 is appropriate.

    Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

    Purpose5/5

    Does the description clearly state what the tool does and how it differs from similar tools?

    The description clearly states the action ('List') and the resource ('deals/opportunities from Teamleader Focus'), and the filter options help distinguish it from other deal-related tools like teamleader_deal_info or teamleader_deal_create. It is specific and unambiguous.

    Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

    Usage Guidelines3/5

    Does the description explain when to use this tool, when not to, or what alternatives exist?

    The description implies usage for listing deals and mentions filter dimensions, but it does not explicitly state when to choose this tool over alternatives such as teamleader_deal_info or other list tools. No exclusions or when-not-to-use guidance is provided.

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

  • Behavior2/5

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

    No annotations are present, so the description must disclose behavioral traits. It only says 'Mark a deal as won' without explaining permissions, reversibility, side effects, or validation rules. This is a significant gap for a mutation tool.

    Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

    Conciseness5/5

    Is the description appropriately sized, front-loaded, and free of redundancy?

    The description is a single sentence: 'Mark a deal as won.' It is concise, front-loaded with the verb, and contains no unnecessary information.

    Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

    Completeness3/5

    Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

    The tool is simple with one parameter and no output schema, but the description lacks context on prerequisites (e.g., deal must exist and be in a state that allows winning) and consequences. It is minimally complete but leaves room for ambiguity.

    Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

    Parameters3/5

    Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

    The input schema has 100% coverage with 'id' described as 'Deal UUID'. The description does not add any further meaning about the parameter, but the schema already handles it, warranting the baseline score of 3.

    Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

    Purpose5/5

    Does the description clearly state what the tool does and how it differs from similar tools?

    The description 'Mark a deal as won' clearly states the action (mark) and the resource (deal) with the specific outcome (won). It distinguishes itself from sibling tools like `teamleader_deal_lose`, which marks a deal as lost.

    Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

    Usage Guidelines3/5

    Does the description explain when to use this tool, when not to, or what alternatives exist?

    The description implies usage when a deal is won, but it does not explicitly state when to use this tool versus alternatives like `teamleader_deal_update` or `teamleader_deal_lose`. No exclusionary criteria or alternative recommendations are provided.

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

  • Behavior2/5

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

    No annotations are provided, so the description carries the full burden. It discloses the linking behavior but doesn't mention whether the email is sent or only logged, required permissions, idempotency, or the response/return value. This is a significant gap for a write operation.

    Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

    Conciseness5/5

    Is the description appropriately sized, front-loaded, and free of redundancy?

    Two short sentences that are front-loaded and directly state the purpose. No filler, redundancy, or unnecessary detail.

    Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

    Completeness3/5

    Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

    The schema is rich and required params are clear, but the description lacks behavioral context such as whether this tool sends or only logs, requires prior entity existence, or what the operation returns. Given no output schema and no annotations, the description is adequate but not fully complete.

    Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

    Parameters3/5

    Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

    All six parameters are described in the schema with 100% coverage, so the baseline is 3. The description adds a general notion of linking to entities ('to a contact, company, or deal'), but that simply restates subject_type values and doesn't add new semantic detail.

    Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

    Purpose5/5

    Does the description clearly state what the tool does and how it differs from similar tools?

    The description uses a specific verb ('Track/log') and identifies the resource ('an email in Teamleader Focus'), and clarifies it links to a contact, company, or deal. This clearly distinguishes it from sibling tools like teamleader_emails_list, which is for listing emails.

    Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

    Usage Guidelines3/5

    Does the description explain when to use this tool, when not to, or what alternatives exist?

    The description implies use for recording an email and associating it with an entity, but it doesn't explicitly state when to use this over alternatives (e.g., teamleader_emails_list for reading). There is no mention of prerequisites, exclusions, or when not to use the tool.

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

  • Behavior2/5

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

    No annotations are provided, so the description carries the full burden of behavioral disclosure. It only says 'Create a new product'—which merely restates the tool's name without adding detail about side effects, idempotency, required permissions, or return values. There is no mention of whether duplicates are allowed, what happens on failure, or what response the user can expect.

    Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

    Conciseness5/5

    Is the description appropriately sized, front-loaded, and free of redundancy?

    The description is a single sentence with no filler or redundant wording. It front-loads the core action and resource, making it efficient and easy to parse. No improvement needed for brevity.

    Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

    Completeness3/5

    Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

    Given the tool's simplicity (6 parameters, 1 required, no nested objects, no output schema) and the schema's full parameter documentation, the description is minimally viable. However, it lacks any mention of return value, creation behavior, or prerequisites, which would be helpful for a create operation in the absence of annotations and an output schema.

    Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

    Parameters3/5

    Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

    The input schema has 100% coverage with descriptions for all six parameters, so the baseline is 3. The description does not add any additional meaning beyond the schema, but the schema itself already documents each parameter adequately.

    Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

    Purpose5/5

    Does the description clearly state what the tool does and how it differs from similar tools?

    The description clearly states the specific action ('Create') and the resource ('new product in Teamleader Focus'), which unambiguously distinguishes it from sibling tools like list, info, and update operations. It is concise and uses a specific verb+resource structure.

    Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

    Usage Guidelines3/5

    Does the description explain when to use this tool, when not to, or what alternatives exist?

    The description implies usage (when you need to create a product), but it does not explicitly state when to use this tool vs alternatives (e.g., 'use product_update to modify an existing product'). No exclusions or alternate tool references are given, leaving guidance to be inferred from the name and context.

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

  • Behavior2/5

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

    No annotations are provided, so the description carries the full burden. The description only restates the tool's purpose ('get details') with no additional behavioral context such as error handling, permissions, or response format. It is a clear read operation, but no non-obvious traits are disclosed.

    Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

    Conciseness5/5

    Is the description appropriately sized, front-loaded, and free of redundancy?

    The description is a single sentence with no wasted words. It is appropriately sized for a simple get-by-ID tool, front-loaded with the core action.

    Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

    Completeness3/5

    Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

    For a simple read-only tool with one parameter, the description is minimally viable but incomplete: it does not specify what 'details' include or what happens if the product is not found. Since there is no output schema to fill that gap, the description could have added a bit more context.

    Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

    Parameters3/5

    Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

    The schema already fully documents the single 'id' parameter as a Product UUID, so baseline is 3. The description's 'by ID' adds no extra meaning beyond the schema, making it redundant but not harmful.

    Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

    Purpose5/5

    Does the description clearly state what the tool does and how it differs from similar tools?

    The description clearly states the tool retrieves details for a specific product by ID, which distinguishes it from sibling tools like teamleader_products_list (list all) and teamleader_product_create/update (mutations). The verb 'Get' and resource 'product' are specific.

    Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

    Usage Guidelines3/5

    Does the description explain when to use this tool, when not to, or what alternatives exist?

    The description implies this tool should be used when a product ID is known, but it does not explicitly state when to use it over alternatives like teamleader_products_list. No exclusions or alternative references are provided, making the usage guidance only implicit.

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

  • Behavior2/5

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

    No annotations are provided, and the description gives minimal behavioral detail—it does not state whether the link is temporary, whether it requires prior creation/sending of the quotation, or what the response contains beyond a link.

    Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

    Conciseness5/5

    Is the description appropriately sized, front-loaded, and free of redundancy?

    The description is a single, front-loaded sentence that contains no filler words and conveys the core purpose efficiently.

    Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

    Completeness3/5

    Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

    For a low-complexity tool with one parameter, the description covers the basic purpose but omits potential behavioral context (e.g., conditions for link generation, link expiry) and does not describe the return format, given there is no output schema.

    Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

    Parameters3/5

    Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

    The singular parameter 'id' is already described as 'Quotation UUID' in the schema (100% coverage), and the description adds no additional semantic context about how the id is used or validated.

    Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

    Purpose5/5

    Does the description clearly state what the tool does and how it differs from similar tools?

    The description clearly states a specific action ('Get') and resource ('download link for a quotation PDF'), and is distinct from sibling tools like quotation_send or quotation_accept, which cover different operations.

    Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

    Usage Guidelines3/5

    Does the description explain when to use this tool, when not to, or what alternatives exist?

    The description implies the tool is used when a download link is needed, but provides no explicit guidance on when to choose this over alternatives, nor any prerequisites or exclusions.

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

  • Behavior2/5

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

    No annotations are provided, so the description carries the full burden of behavioral disclosure. It only states the basic read action without disclosing any behavioral traits such as required permissions, potential errors (e.g., not found), or response format. This is a significant gap for an unannotated read tool.

    Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

    Conciseness5/5

    Is the description appropriately sized, front-loaded, and free of redundancy?

    One concise sentence, front-loaded with action and resource, with zero unnecessary words. Perfectly sized for the simple purpose.

    Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

    Completeness3/5

    Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

    Given the tool's simplicity (single parameter, no nested objects, no output schema), the description is minimally adequate but lacks any information about return value, error behavior, or usage context. With no annotations or output schema, more explanation would be expected for full completeness.

    Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

    Parameters3/5

    Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

    The input schema already describes the only parameter `id` as 'Quotation UUID' with 100% coverage, so the description adds nothing beyond the structured data. A baseline of 3 is appropriate when schema provides full parameter documentation.

    Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

    Purpose5/5

    Does the description clearly state what the tool does and how it differs from similar tools?

    The description clearly states the action ('Get') and resource ('details of a specific quotation'), and specifies retrieval by ID. This distinguishes it from sibling tools like quotations_list, quotation_create, and quotation_update.

    Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

    Usage Guidelines3/5

    Does the description explain when to use this tool, when not to, or what alternatives exist?

    Implies usage when a specific quotation ID is known and details are needed, but does not explicitly mention when to use it over alternatives like quotations_list. No exclusions or prerequisites are stated.

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

  • Behavior3/5

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

    There are no annotations, so the description carries the full burden. It does disclose that the tool returns contact details and linked companies, which adds context beyond the tool name. However, it does not mention error behavior, permissions, or return structure, leaving some uncertainty.

    Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

    Conciseness5/5

    Is the description appropriately sized, front-loaded, and free of redundancy?

    The description is a single, front-loaded sentence that conveys the core purpose and a key output detail with zero unnecessary words.

    Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

    Completeness4/5

    Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

    For a simple 1-parameter tool with no output schema, the description is nearly sufficient: it states what is returned (details and linked companies). It could be more complete by noting not-found behavior, but overall it gives enough context for a straightforward get-by-ID operation.

    Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

    Parameters3/5

    Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

    The schema already describes the only parameter 'id' as 'Contact UUID' (100% coverage). The description's 'by ID' adds no additional parameter meaning beyond what the schema provides, so the baseline of 3 applies.

    Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

    Purpose5/5

    Does the description clearly state what the tool does and how it differs from similar tools?

    The description clearly states the specific action ('Get details') and resource ('a specific contact by ID'), and adds the useful qualifier 'including linked companies.' It unambiguously distinguishes this from list-style siblings like teamleader_contacts_list by emphasizing a single contact and by ID.

    Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

    Usage Guidelines2/5

    Does the description explain when to use this tool, when not to, or what alternatives exist?

    No explicit guidance is given on when to use this tool versus alternatives such as teamleader_contacts_list or teamleader_company_info. The context implies use when you have a contact ID, but there is no mention of alternatives or exclusions.

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

  • Behavior2/5

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

    With no annotations provided, the description carries the full burden. It confirms the read-only action and filter options, but does not disclose pagination behavior, whether filters combine with AND/OR, the scope of events returned (e.g., all users vs. only authenticated user), or the response structure. For a list operation with six optional filters, these are significant gaps.

    Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

    Conciseness5/5

    Is the description appropriately sized, front-loaded, and free of redundancy?

    The description is a single, front-loaded sentence with no filler, making it easy to parse and directly conveying the core action and filter support.

    Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

    Completeness2/5

    Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

    Given the absence of an output schema and annotations, the description is too thin to fully support invocation. It does not indicate what fields are returned in the list, whether there are pagination limits, or how the optional filters interact (e.g., AND/OR semantics). The parameter schema is thorough, but the tool's behavior and output remain under-specified.

    Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

    Parameters3/5

    Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

    Schema descriptions cover 100% of the parameters with format details. The description's mention of 'date range, contact, company, or deal' merely summarizes the parameter names already present in the schema, adding no additional semantic value beyond what the schema provides.

    Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

    Purpose5/5

    Does the description clearly state what the tool does and how it differs from similar tools?

    The description uses the specific verb 'List' and clearly identifies the resource as 'calendar events from Teamleader Focus', with a concise enumeration of filter dimensions. This clearly distinguishes it from sibling tools like teamleader_event_info (single event) and teamleader_event_create.

    Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

    Usage Guidelines4/5

    Does the description explain when to use this tool, when not to, or what alternatives exist?

    The description gives clear context that this tool is for listing events with optional filters, implying broad retrieval use. However, it does not explicitly state when to prefer teamleader_event_info for a single event or mention any exclusions, so it stops short of explicit alternative guidance.

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

  • Behavior2/5

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

    No annotations are provided, so the description must carry the burden. It only says 'Get details' without disclosing permissions, return format, error behavior, or what 'details' includes. This adds little beyond the tool name and schema.

    Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

    Conciseness4/5

    Is the description appropriately sized, front-loaded, and free of redundancy?

    The description is a single, concise sentence with the verb and resource front-loaded. It is efficient, though somewhat under-specified, but not tautological or bloated.

    Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

    Completeness3/5

    Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

    For a simple get-by-ID tool with one parameter and no output schema, the description covers the basic purpose. However, it lacks behavioral details and usage guidance, which is a gap given no annotations to complement it.

    Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

    Parameters3/5

    Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

    The input schema fully describes the 'id' parameter as 'Invoice UUID' (100% coverage). The description merely restates 'by ID' without adding extra meaning, so baseline 3 applies per schema coverage.

    Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

    Purpose5/5

    Does the description clearly state what the tool does and how it differs from similar tools?

    The description clearly states the action ('Get details'), resource ('specific invoice'), and method ('by ID'). This distinguishes it from sibling tools like the invoice list or invoice action tools.

    Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

    Usage Guidelines4/5

    Does the description explain when to use this tool, when not to, or what alternatives exist?

    The context is clear: use this tool when you have a specific invoice ID and need details. However, it does not explicitly mention alternatives or when not to use it, but the 'by ID' phrasing implies the intended usage.

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

  • Behavior3/5

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

    With no annotations provided, the description must convey the tool's behavior. It indicates a read operation via 'Get,' but it does not disclose error behavior for nonexistent IDs, authentication requirements, or what is included in 'details.' This is a basic level of transparency.

    Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

    Conciseness5/5

    Is the description appropriately sized, front-loaded, and free of redundancy?

    The description is a single sentence containing only essential information. It is front-loaded and has no filler words, making it highly efficient.

    Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

    Completeness3/5

    Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

    Given the tool's low complexity and single parameter, the description is minimally sufficient but lacks details about the response format and error handling. Since there is no output schema, the description should clarify what 'details' means or what the return value contains, which it does not. Still, the core purpose and input are communicated clearly.

    Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

    Parameters3/5

    Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

    The input schema already documents the single 'id' parameter as an Event UUID, giving 100% coverage. The description adds little beyond mentioning 'by ID,' which is redundant. Per the rubric, the baseline of 3 applies because schema coverage is high.

    Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

    Purpose5/5

    Does the description clearly state what the tool does and how it differs from similar tools?

    The description clearly states the tool retrieves details for a specific calendar event using its ID. The verb 'Get' and the resource 'calendar event' precisely define the action, and it is distinct from sibling tools like events_list and event_create.

    Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

    Usage Guidelines3/5

    Does the description explain when to use this tool, when not to, or what alternatives exist?

    The description implies usage when an event ID is available, but it does not explicitly mention alternatives or when not to use this tool. For example, it does not say 'use events_list to find the ID first' or 'use event_create to make a new event.' This is adequate but vague.

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

  • Behavior2/5

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

    With no annotations provided, the description must disclose behavioral traits. It states the action ('finalize') but does not mention that booking is likely irreversible, that the invoice must be in draft state, or any permission requirements. For a mutation that changes the invoice's lifecycle, this lack of cautionary context is a notable gap.

    Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

    Conciseness5/5

    Is the description appropriately sized, front-loaded, and free of redundancy?

    The description is a single, concise sentence that efficiently conveys the core action and clarifies the meaning of 'book' with a parenthetical. There is no filler or redundant information, and the key verb is front-loaded.

    Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

    Completeness3/5

    Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

    The tool is simple, and the schema fully documents its two parameters. However, the description lacks important details about the finalization process, such as irreversibility or prerequisite state, which are important for a state-changing operation with no output schema to clarify the result. It is minimally sufficient but not fully contextualized.

    Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

    Parameters3/5

    Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

    The schema description covers 100% of the parameters (id = Invoice UUID, on = Booking date), so the baseline is 3. The description does not add any extra meaning about the parameters, but it doesn't need to since the schema already provides complete definitions.

    Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

    Purpose5/5

    Does the description clearly state what the tool does and how it differs from similar tools?

    The description uses a specific verb ('book') and a clear resource ('draft invoice') with a clarifying parenthetical that equates booking with finalizing. This distinguishes it from sibling tools like teamleader_invoice_draft (which creates a draft) and teamleader_invoice_send (which sends an invoice).

    Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

    Usage Guidelines4/5

    Does the description explain when to use this tool, when not to, or what alternatives exist?

    The description implies the tool is for converting a draft invoice into a finalized state, which gives clear context for when to use it. It does not explicitly state exclusions or alternative tools, but the parenthetical and the phrase 'draft invoice' strongly signal the appropriate scenario. No explicit when-not-to-use guidance, but the intent is not ambiguous.

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

  • Behavior2/5

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

    No annotations are provided, so the description must fully disclose behavior. It states the target of deletion but does not mention irreversibility, required permissions, or potential consequences. For a destructive action, this lack of disclosure is a significant gap.

    Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

    Conciseness5/5

    Is the description appropriately sized, front-loaded, and free of redundancy?

    The description is a single, short sentence that immediately states the action and target. There is no redundancy or unnecessary detail, making it highly efficient.

    Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

    Completeness3/5

    Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

    The tool has only one parameter and no output schema, so the description is relatively complete for a simple operation. However, it lacks details on error conditions (e.g., what happens if the invoice is not draft or last booked) and any side effects, which leaves minor gaps.

    Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

    Parameters4/5

    Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

    The schema already documents 'id' as an Invoice UUID (100% coverage). The description adds meaningful context by constraining which invoices are valid (draft or last booked), thereby explaining when a particular id is acceptable. This goes beyond the schema's basic type definition.

    Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

    Purpose5/5

    Does the description clearly state what the tool does and how it differs from similar tools?

    The description uses the specific verb 'Delete' and identifies the resource 'invoice' with a clear qualifier 'draft or the last booked invoice.' This distinguishes it from other invoice-related tools (send, book, register payment) and clearly states what the tool does.

    Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

    Usage Guidelines4/5

    Does the description explain when to use this tool, when not to, or what alternatives exist?

    The description provides a clear context by specifying the exact conditions under which deletion is allowed (draft or last booked invoice). While it does not explicitly mention alternatives, the boundary is clear and no exclusions are stated, making it appropriate for most use cases.

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

  • Behavior3/5

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

    With no annotations, the description carries the burden of disclosing behavior. It mentions the pagination limit ('Returns max 100 per page') and the filter options, which is useful. However, it does not disclose the return format, default sorting, or whether filters combine as AND/OR, leaving some behavioral ambiguity.

    Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

    Conciseness5/5

    Is the description appropriately sized, front-loaded, and free of redundancy?

    The description is concise and well-structured: two sentences with the core purpose first, then filtering capabilities and pagination limit. Every sentence earns its place without redundancy or fluff.

    Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

    Completeness3/5

    Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

    Given the tool has 8 optional parameters, no annotations, and no output schema, the description is adequate but incomplete. It clarifies pagination and filter categories, which helps an agent select the tool, but lacks details on return content, ordering, or the meaning of customer_type. It meets the minimum viable threshold but does not fully compensate for missing structured context.

    Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

    Parameters3/5

    Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

    Schema description coverage is high (88%), so the schema already documents most parameters. The description adds a grouping of filters (status, customer, date) that provides context beyond individual schema entries, but it does not explain parameter interactions or provide additional details for customer_type or term.

    Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

    Purpose5/5

    Does the description clearly state what the tool does and how it differs from similar tools?

    The description clearly states a specific verb+resource: 'List invoices from Teamleader Focus.' It also specifies filtering capabilities (status, customer, date) and pagination, distinguishing it from single-invoice tools like teamleader_invoice_info and other resource-specific list tools.

    Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

    Usage Guidelines4/5

    Does the description explain when to use this tool, when not to, or what alternatives exist?

    The description provides clear usage context by indicating what the tool does (listing with filters) and hints at when it would be appropriate (when needing multiple invoices). However, it does not explicitly mention alternatives or when not to use it, such as when a single invoice's full details are needed (favoring teamleader_invoice_info).

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

  • Behavior3/5

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

    With no annotations provided, the description carries the full behavioral disclosure burden. 'Get details' correctly implies a read-only operation and suggests the return of the full entry, but it doesn't mention error handling, return format, or any edge cases. Acceptable for a simple read tool but lacks depth.

    Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

    Conciseness5/5

    Is the description appropriately sized, front-loaded, and free of redundancy?

    The description is a single, front-loaded sentence with zero wasted words. It communicates the action, object, and scope efficiently.

    Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

    Completeness3/5

    Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

    For a simple tool with one well-documented parameter, the description is sufficient to explain the basic operation. However, without an output schema or annotations, it leaves the agent uncertain about the exact contents of 'details', error responses, and relation to the list tool. It meets the minimum viable bar but has clear gaps.

    Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

    Parameters3/5

    Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

    The input schema already fully covers the 'id' parameter with description 'Time tracking UUID', providing 100% coverage. The description's 'by ID' adds no extra semantic meaning beyond the schema, so baseline 3 is appropriate.

    Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

    Purpose5/5

    Does the description clearly state what the tool does and how it differs from similar tools?

    The description uses a specific verb ('Get details') and resource ('time tracking entry by ID'), clearly distinguishing it from sibling tools like teamleader_timetracking_list (list all) and teamleader_timetracking_update (modify). It exactly matches the tool's intended function.

    Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

    Usage Guidelines4/5

    Does the description explain when to use this tool, when not to, or what alternatives exist?

    The description makes it clear this tool is for retrieving details when you have a specific time tracking ID. It doesn't explicitly name alternatives or exclusions, but for a simple get-by-id tool the usage context is implicitly obvious and adequate.

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

  • Behavior3/5

    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 a read operation ('Get') with no side effects, but does not elaborate on return format, error behavior, or access requirements. For a simple get-by-ID, this is acceptable but not rich; there is no contradiction with annotations since none exist.

    Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

    Conciseness5/5

    Is the description appropriately sized, front-loaded, and free of redundancy?

    The description is a single, front-loaded sentence with no filler. Every word contributes to the core purpose, making it appropriately concise and well-structured.

    Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

    Completeness4/5

    Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

    Despite lacking annotations and an output schema, the tool's simplicity (one parameter, clear read purpose) means the description covers the essential context. It does not explain return details, but for a get-by-ID tool, the provided information is sufficient for an agent to select and invoke it correctly.

    Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

    Parameters3/5

    Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

    Schema description coverage is 100%, with the only parameter 'id' already described as 'Deal UUID'. The description's phrase 'by ID' is redundant with the schema and adds no new meaning beyond what structured data provides. Thus the baseline of 3 applies.

    Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

    Purpose5/5

    Does the description clearly state what the tool does and how it differs from similar tools?

    The description clearly states the verb 'Get' plus the specific resource 'details of a specific deal by ID'. It distinguishes this tool from siblings like teamleader_deals_list (which lists deals) and teamleader_deal_update (which modifies deals), identifying a unique read-by-ID action.

    Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

    Usage Guidelines4/5

    Does the description explain when to use this tool, when not to, or what alternatives exist?

    The context is clear: use when you need details for a specific deal identified by its ID. The description does not explicitly mention alternatives or exclusions, but the singular focus on 'specific deal' implies appropriate usage, and sibling tools for other operations are not mentioned. This meets the 'clear context, no exclusions' level.

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

  • Behavior3/5

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

    No annotations are provided, so the description carries the full burden. It implies a read-only operation via 'List' and scopes results to 'tracked emails', but it does not disclose any potential limitations, pagination behavior, or error conditions. For a simple read tool, this is adequate but not rich.

    Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

    Conciseness5/5

    Is the description appropriately sized, front-loaded, and free of redundancy?

    The description is two succinct sentences. It front-loads the primary action and immediately states the critical requirement, with no wasted words. This is concise and well-structured.

    Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

    Completeness4/5

    Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

    Given the tool's simplicity and the presence of a well-documented schema, the description provides enough context for correct invocation. However, no output schema is present, and the description does not hint at the return format, which might be expected for a list tool. Still, for a basic filtered list, it is largely complete.

    Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

    Parameters3/5

    Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

    Schema description coverage is 100%, with both parameters having descriptive comments. The description adds minimal semantic value by stating the filter purpose ('to filter by linked entity'), which is largely redundant with the schema. It does not provide additional syntax or behavioral details beyond the schema.

    Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

    Purpose5/5

    Does the description clearly state what the tool does and how it differs from similar tools?

    The description clearly states the tool lists tracked emails from Teamleader Focus, using a specific verb and resource. It distinguishes from sibling list tools by focusing on emails, and mentions the required filter for linked entities.

    Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

    Usage Guidelines4/5

    Does the description explain when to use this tool, when not to, or what alternatives exist?

    The description clearly conveys that both subject_type and subject_id are required, which is essential usage context. It does not explicitly mention when to use this tool versus alternatives, but the scope is clear enough for the user to understand it is for listing emails only.

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

GitHub Badge

Glama performs regular codebase and documentation scans to:

  • Confirm that the MCP server is working as expected.
  • Confirm that there are no obvious security issues.
  • Evaluate tool definition quality.

Our badge communicates server capabilities, safety, and installation instructions.

Card Badge

teamleader-mcp MCP server

Copy to your README.md:

Score Badge

teamleader-mcp MCP server

Copy to your README.md:

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Weichie-com/teamleader-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server