Server Quality Checklist

Tool Scores

• jotify_upload_mediaA
  3.5/5.0
  Behavior2/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 mentions the operation (upload) but does not disclose side effects (e.g., file persistence, overwriting), required permissions, or constraints (e.g., file size limits, URL accessibility). The description is too brief to provide meaningful behavioral 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 sentence, highly concise with no fluff. It front-loads the core purpose and lists the key input methods efficiently. Every word is necessary, and it avoids redundancy.

  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 complex tool (5 parameters, multiple input methods, no annotations), the description is minimal but covers the essential input options. However, it lacks constraints (e.g., which parameters are mutually exclusive, size limits) and does not mention return values or error handling, which are not covered by an output schema. The description is adequate for basic understanding but misses critical usage 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 schema has 100% parameter description coverage, so the baseline is 3. The tool description adds no additional parameter semantics, but it does summarize the three input methods (path, URL, Base64) which reinforces the schema. However, it doesn't clarify mutual exclusivity or precedence among 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 clearly states the tool uploads a single media file to a Jotify Moment, specifying three input methods (local path, external URL, Base64). It focuses on the specific action (upload) and resource (Jotify Moment), distinguishing it from siblings like 'jotify_upload_batch' which implies batch upload.

  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 by listing input methods, but lacks explicit guidance on when to use this vs. alternatives (e.g., batch upload) or when not to use it. No alternative tools are mentioned. It does not specify prerequisites or context like needing a moment ID.

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

• jotify_create_postA
  3.6/5.0
  Behavior3/5

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

  With no annotations, the description carries the full burden. It discloses supported media types and Markdown formatting, but does not describe the return value, post visibility, or any side effects of publishing. This is a modest disclosure for a create 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?

  The description is a single concise sentence in Chinese, front-loaded with the main action and without any unnecessary words. It efficiently conveys the core purpose and key features.

  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 create operation with no output schema, the description covers the main purpose, media types, and Markdown support, but lacks critical context such as return values, required authentication, or explanation of embedId/embedType. It is minimally viable but leaves meaningful gaps.

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

  Parameters2/5

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

  Schema description coverage is only 50% (content and mediaUrls are described, embedId and embedType are not). The tool description adds some context for content (Markdown) and mediaUrls (media types), but completely ignores embedId and embedType, leaving them ambiguous in both schema and description.

  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: publish an image-text/audio-video post on the Jotify Moment platform, and notes Markdown support. This specific verb+resource distinguishes it from sibling tools like upload_media and list_recent_posts.

  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 a workflow by mentioning that mediaUrls can be obtained via the upload interface, hinting at when upload tools might precede this one. However, it lacks explicit when-to-use or alternative tool guidance, leaving differentiation mostly implicit.

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

• jotify_upload_batchA
  3.6/5.0
  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 transparency. It mentions returning a media list but does not disclose side effects such as whether uploads are permanent, if partial failures are possible, or authentication requirements, leaving a significant transparency gap.

  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 entire description is one sentence that front-loads the key action ('一次性批量上传') and outcome ('返回已上传的媒体列表'). Some redundancy exists between '一次性' and '批量', but it remains concise and free of waste.

  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 tool with no output schema and no annotations, the description provides the core use case and return value, but leaves questions about parameter interaction (e.g., 'items' vs 'filePaths') and error handling unanswered. The moderate complexity of three parameters and one enum warrants slightly more context than provided.

  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% according to context signals, with all three parameters described in the schema (e.g., '业务用途' and '待上传的媒体数组'). The description adds minimal parameter-specific value beyond the schema, but the schema itself is self-sufficient, 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.

  Purpose5/5

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

  The description uses the specific verb '批量上传' (batch upload) with clear resources ('多张图片或音视频') and states it returns a media list for posting ('返回已上传的媒体列表供发帖使用'). This clearly differentiates from the sibling single-upload tool 'jotify_upload_media' by emphasizing the batch and turn-saving nature.

  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 phrase '极大减少交互轮次' (greatly reduces interaction turns) implies a recommended use case for batch uploads rather than repeated single uploads. However, it does not explicitly name alternatives or state when not to use it, so guidance is implied rather than explicit.

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

• jotify_list_recent_postsA
  4/5.0
  Behavior3/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 of behavioral disclosure. It reveals that only public posts are returned and that they are recent, implying a read-only operation. However, it does not explicitly state safety (e.g., no side effects), authentication requirements, or pagination behavior beyond the limit parameter. It adds some value but is not comprehensive.

  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 front-loads the core purpose and then adds the key filtering option. Every word contributes to the meaning; there is no filler or redundancy, making it highly efficient for AI parsing.

  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 (2 optional parameters, no output schema), the description adequately covers the essentials: what the tool does, the data scope (public and recent), and the filtering dimension. It could be improved by explicitly stating the output structure or ordering, but the phrase '最近发布' implies recency sorting. Overall, it is sufficiently complete for a basic list query 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 description coverage is 100%, so both parameters are already documented. The description reinforces the tag filter by mentioning '#topic/tag', which adds minimal additional meaning. The limit parameter is not mentioned in the description, but the schema already covers its default value and role. Since the schema handles the semantics, this dimension is at 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 the tool's purpose: to query the list of recent public posts on the Jotify Moment platform, with optional tag filtering. It uses specific verbs ('查询' meaning query/list) and a distinct resource ('公开动态列表' - public posts list), effectively distinguishing it from siblings like create_post or upload_media.

  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 mentions the filtering capability by #topic/tag, indicating when to use this parameter. However, it does not explicitly state when to use this tool versus alternatives (e.g., for retrieving a single user's profile), though the name and purpose make the use case clear. It provides context (recent public posts) without exclusions or integration guidance.

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

• jotify_get_profileA
  4.4/5.0
  Behavior4/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 that API key verification is part of the operation and specifies what data is returned (nickname, slug, role). While it doesn't mention read-only status or potential side effects, the 'get' verb and profile context imply a safe read 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?

  The description is a single, concise sentence that front-loads the purpose. It wastes no words and includes useful details about fields returned.

  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 tool with no parameters, no output schema, and no annotations, the description is adequately complete. It covers purpose, auth verification, and the content of the response. It could be considered complete enough given the tool's simplicity.

  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?

  There are zero parameters, so the baseline is 4. The description does not need to explain parameter semantics, and it correctly avoids mentioning any 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 clearly states the verb '获取' (get) and the resource '当前登录用户的个人资料' (current logged-in user's profile), and lists specific fields (nickname, Slug, role). This distinguishes it from sibling tools which handle media uploads and post creation.

  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 usage context by indicating it verifies API key and fetches profile, which is a distinct operation from the sibling tools. It does not explicitly state when not to use it, but the context is clear enough given the tool's purpose.

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