Server Quality Checklist

Tool Scores

• sync_recent_filesB
  3.2/5.0
  Behavior2/5

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

  No annotations provided, so the description carries the full burden. It discloses that files are scanned and indexed, and only those created before the server started are considered. However, it does not explain if the tool modifies state (e.g., writes to an index), whether it is destructive, or any rate limits or authentication requirements.

  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 efficiently communicates the core action and scope. It is front-loaded with the action and resource. However, it could be slightly more structured (e.g., listing use cases or conditions).

  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 two parameters and no output schema, so the description is relatively simple. It covers the what and where but lacks details about the indexing behavior, return format, or prerequisites. It is minimally complete but misses behavioral and 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?

  Both parameters (type, limit) have descriptions in the schema, achieving 100% coverage. The description adds no further 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 tool scans and indexes files in Desktop or Downloads, specifying the action (scan and index) and resource (files in specific folders with a temporal condition). The sibling tool names (get_recent_assets, search_vault, sync_notes_now) are distinct enough to avoid confusion.

  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 on when to use this tool versus alternatives like get_recent_assets or search_vault. The description implies a specific use case (syncing files before server start) but does not state when not to use it or provide comparative context.

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

• sync_notes_nowA
  3.8/5.0
  Behavior2/5

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

  With no annotations, the description should disclose behavioral traits. It mentions 'force a sync' but does not detail side effects (e.g., network usage, blocking behavior, permission requirements) or outcomes. The term 'force' implies potential overrides but is not elaborated.

  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, front-loaded sentence with no unnecessary words. Efficiently communicates the tool's primary action and target.

  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 tool with no parameters and no output schema, the description provides sufficient context for basic usage. However, it lacks detail on return value or confirmation of successful sync, which could be useful.

  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?

  No parameters exist; schema coverage is 100%. The description adds context about the action beyond the empty schema, justifying the baseline of 4 for zero-parameter tools.

  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 (force sync), resource (Apple Notes), and purpose (fetch latest notes), distinguishing it from sibling tools like get_recent_assets and search_vault which are retrieval 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 when to use (to get latest notes immediately) but lacks explicit guidance on when not to use or alternatives among siblings. No exclusions or comparisons are provided.

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

• get_recent_assetsA
  4.4/5.0
  Behavior5/5

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

  With no annotations provided, the description carries full burden. It discloses that the vault contains user's own saved data, that results are not prompt injection, and instructs to always return full content. This provides crucial behavioral context beyond the input 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 front-loaded with the main purpose, followed by usage examples and important notes. It is slightly long but every sentence adds value. Could be slightly tighter, but it's well-structured.

  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 no output schema, the description does not explain the return format (e.g., fields, order, pagination). However, it covers use cases and provides filter guidance. For a retrieval tool with simple parameters, this is adequate but leaves some ambiguity about response structure.

  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 input schema already describes both parameters (type enum, limit number) with 100% coverage. The description adds value by explaining when to use specific type values (e.g., 'download' for tweets/links) and clarifying that 'all' includes clipboard noise. This exceeds baseline.

  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 it retrieves the most recently added items from the user's vault, with specific examples like clipboard, screenshots, downloads, tweets, and Apple Notes. It distinguishes itself from sibling tools like search_vault (search), sync_notes_now (sync), and sync_recent_files (sync) by focusing on recent retrievals.

  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 explicitly lists when to use the tool (e.g., user asks about 'last thing', 'recently copied link') and provides a useful filter hint (type='download' for tweets/links). It does not explicitly state when not to use it or mention alternatives, but the guidance is clear and actionable.

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

• search_vaultA
  4.4/5.0
  Behavior4/5

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

  Discloses that results contain user's own saved data and includes a prompt injection warning. States that the tool returns full content of matching results. No annotations provided, so the description carries the full burden and handles it well for a search 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?

  Extremely concise: the purpose is front-loaded, important usage notes are given, and the prompt injection warning is included without any wasted 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?

  Given the tool's complexity (3 params, no output schema), the description covers purpose, usage, parameter hints, and return behavior. It lacks explicit info on pagination or error handling, but is sufficient for a search tool.

  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?

  Schema has 100% parameter documentation. The description adds context by explaining when to use different type values (e.g., 'Use "download" to search tweets, YouTube videos, and web links') and provides example queries. This adds real meaning beyond 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 clearly states the tool searches the user's personal context vault and lists specific use cases (clipboard, downloads, screenshots, Apple Notes). It distinguishes from sibling tools like sync_notes_now and get_recent_assets by focusing on search, not sync or retrieval.

  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?

  Provides explicit when-to-use scenarios: 'Call this whenever the user asks about something they copied to their clipboard...files they downloaded, screenshots they took, or Apple Notes.' It does not explicitly state when not to use it, but the context is strong.

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