Server Quality Checklist

Tool Scores

• yagames-update-draftC
  2.7/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 of behavioral disclosure. It does disclose the authentication-env-var prerequisite, a genuine operational fact beyond the name. But it never states whether the update is a partial patch or full replacement, what happens if the draft is already in moderation, or whether changes affect a published game.

  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?

  Two short sentences, front-loaded with the action and resource, with the prerequisite in a clean second sentence. Nothing is wasted, though the terseness borders on under-specification for an 11-parameter mutation tool.

  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 11 parameters, no annotations, and no output schema, the description is under-equipped: no update semantics, no effect on moderation state, no return-value information. The auth note is the only contextual hint, and required-parameter semantics beyond 'appId is the console ID' are absent.

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

  Parameters1/5

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

  Schema coverage is only 9% — ten of eleven parameters (tags, title, category, howToPlay, languages, platforms, cloudSaves, description, orientation, ageRating) have no schema description — so the tool description must compensate. It provides zero information about any parameter: no guidance on which fields are updatable, how to format them, or how they interact.

  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?

  States a specific action ('Update') on a specific resource ('an existing game draft'), and the word 'existing' implicitly separates it from the sibling yagames-create-draft. However, it adds little beyond the tool name itself and relies on inference rather than explicitly naming distinguishing scope.

  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?

  Gives no guidance on when to use this tool versus its nine siblings. The 'Requires authentication env vars' note is a prerequisite, not a selection criterion; there is no mention that create-draft is for new drafts, that upload-build feeds drafts, or where update fits in the moderation/publish workflow.

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

• yagames-searchB
  3.4/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 full burden of behavioral disclosure. It only states the basic action and target; it does not disclose whether the operation is read-only, how results are returned, whether pagination or ordering applies, or whether it searches title, description, or metadata. The search behavior beyond the bare action remains opaque.

  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, efficient sentence with no filler. The action and target are front-loaded, and every word contributes 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?

  The tool has no output schema and no annotations, so the description should clarify what a successful search returns and any notable behavior like empty results or limits. It does not. While the parameter side is complete, the overall description leaves important gaps for an agent deciding whether and how to use the 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%: the only parameter, 'query', is described as 'Search keyword'. The description's 'by keyword' adds no meaning beyond what the schema already provides, so the baseline score 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 states a specific verb ('Search'), a clear resource ('games in the Yandex Games catalog'), and a specific method ('by keyword'). It is immediately distinguishable from sibling tools like yagames-publish or yagames-list-my-games, so an agent can tell which operation this tool performs.

  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 is for keyword-based searching, and the sibling list covers other operations, so the usage context is inferable. However, it does not explicitly state when to use this tool over alternatives or mention any exclusions or prerequisites, leaving some guidance to the agent's inference.

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

• yagames-upload-buildB
  3.4/5.0
  Behavior2/5

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

  With no annotations, the description carries full behavioral disclosure burden. It only notes 'Requires authentication env vars' and the fact that it uploads. It does not disclose side effects, whether an existing build/version is overwritten, validation behavior, or expected results.

  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 one focused sentence with no filler. It front-loads the primary purpose and adds a relevant auth requirement without wasting 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 mutating upload tool with no annotations and no output schema, the description is too sparse. It lacks guidance on selecting this tool over siblings, behavioral expectations, and any post-upload context. The auth note helps but does not make the definition 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%, so the schema already documents all parameters and even adds a useful constraint about index.html in the archive root. The description itself adds no additional parameter-level meaning, 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 states a specific verb ('Upload'), a specific resource ('a game ZIP archive'), and a clear outcome ('as a new build'). This distinguishes it from lifecycle siblings like yagames-update-draft, yagames-submit-moderation, and yagames-publish.

  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 action itself implies when it should be used: when uploading a ZIP as a new build. However, there is no explicit guidance about when to prefer this over yagames-update-draft or other alternatives, and no mention of lifecycle or prerequisite steps beyond auth.

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

• yagames-popularA
  3.6/5.0
  Behavior3/5

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

  With no annotations present, the description carries the behavioral transparency burden. 'Get' clearly conveys a read-only catalog lookup, but the description omits useful behavioral details such as pagination, result limits, ordering, or error behavior for invalid categories.

  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 compact sentence that front-loads the main operation and then adds the one relevant filter caveat. Every word contributes meaning, with no filler or unnecessary detail.

  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 one optional parameter and no output schema, the description is largely sufficient for correct invocation. The only notable gap is the lack of information about the return format, result count, or pagination 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?

  Schema description coverage is 100%, so the single optional category parameter is already well documented with examples and a pointer to yagames-categories. The description adds only the word 'optionally,' which is also implied by the schema having zero required parameters.

  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?

  States the specific operation 'Get popular games' and names the resource, the Yandex Games catalog, with an optional category filter. This is clear and distinct from the search and categories siblings, though it does not explicitly name those alternatives.

  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 this tool—when popular games are wanted—and the category schema points to yagames-categories for valid values. However, it gives no explicit guidance on when to choose this over yagames-search or other catalog-related tools.

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

• yagames-statusA
  3.7/5.0
  Behavior3/5

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

  With no annotations provided, the description carries the burden of behavioral disclosure. It adds the useful requirement 'Requires auth env vars' and the verb 'Check' suggests a read-only operation, but it does not explicitly confirm the absence of side effects, describe error behavior, or mention any rate limits. 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 a single sentence that leads with the action and subject, then lists the relevant statuses and the auth requirement. Every word adds value and there is no 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?

  The tool has no output schema, so the description should clarify what the caller can expect in return. It lists the possible statuses but does not state the response format (e.g., a simple string versus a structured object), nor does it cover error cases like an unknown appId. It is sufficient for a basic understanding but lacks full contextual detail.

  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 input schema already documents 'appId' as 'Game ID'. The description adds no further parameter meaning beyond the term 'game', which is consistent with the schema. Thus the baseline score 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 states a specific verb ('Check') and resource ('current status of a game') and enumerates the possible status values. It is unmistakably distinct from sibling tools like yagames-search, yagames-upload-build, and yagames-publish, so an agent can immediately tell what this 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 when to use the tool: whenever the agent needs to know a game's lifecycle status. However, it does not explicitly name alternatives or state when not to use it, leaving the decision to inference rather than clear routing guidance.

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

• yagames-submit-moderationA
  3.7/5.0
  Behavior3/5

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

  With no annotations, the description carries the burden of behavioral disclosure. It usefully reveals the 3-5 business day delay and auth requirement, but does not mention side effects like the draft becoming locked during review, whether resubmission is allowed, or what the response contains.

  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 includes both the core action and two important operational details. Every word earns its place, with no redundant or filler content.

  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 one-parameter tool, the description gives adequate invocation context: what action is taken, how long it takes, and that auth is needed. However, it lacks guidance on how the agent should verify submission success or handle post-submission status, especially given 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?

  Schema description coverage is 100% and the only parameter appId is already described as 'Game ID'. The description adds no additional semantic detail about the parameter, so the baseline score 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 states a specific verb ('Submit') and resource ('a game draft for moderation review'), which clearly distinguishes it from siblings like yagames-publish and yagames-update-draft. The meaning is immediately 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 mentions the moderation timeline and auth requirement, giving some operational context. However, it does not explicitly state when to use this tool versus the alternatives, such as publishing after approval or updating the draft before submission.

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

• yagames-create-draftA
  3.8/5.0
  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 meaningful operational prerequisite — the two required auth env vars (YAGAMES_SESSION_COOKIE, YAGAMES_CSRF_TOKEN) — which is genuinely useful. However, it does not describe side effects, rate limits, or expected response behavior for the mutation it performs.

  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 sentences with zero waste: the core purpose is front-loaded and the critical auth requirement immediately follows. Every sentence earns its place.

  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 13-parameter create operation, the description covers the biggest hidden prerequisite (auth env vars) while all parameters are fully documented in the schema. The only gap is the absence of return-value/output information, which would help an agent track the created draft, but no output schema exists to offset this.

  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 every parameter (title, category, ageRating, etc.) is already documented with constraints in the input schema. The tool description adds no parameter-level meaning beyond what the schema provides, so the baseline 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 states a specific verb ('Create') and resource ('a new game draft in the Yandex Games Console'), making the tool's function immediately identifiable. The word 'new' also implies creation of a fresh draft, which distinguishes it from the yagames-update-draft sibling.

  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?

  Usage context is implied: 'Create a new game draft' signals this is for initial creation, contrasting with the update-draft sibling in the tool list. However, no explicit when-to-use guidance or exclusion statements are given; the description relies on inference.

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

• yagames-list-my-gamesA
  4/5.0
  Behavior3/5

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

  With no annotations, the description carries full burden. It adds the auth env var requirement and clarifies scope, but it does not state whether the operation is read-only, whether pagination applies, or what exact env vars are needed. The verb 'List' implies read-only, but specifics are sparse.

  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 sentence conveys the action, scope, and a critical prerequisite without filler. Every word adds value and the core behavior is front-loaded.

  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 zero-parameter list operation, the description covers what it lists, whose account it lists, and that auth is required. It does not describe the return format or pagination, but the simple nature and explicit scope make it sufficiently complete for selection and invocation.

  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 has zero parameters and no required inputs, so there is nothing for the description to explain. The baseline for no-parameter tools is 4, and the description correctly avoids inventing unnecessary parameter details.

  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 ('List') and identifies a precise resource ('all games uploaded to your developer account'). The 'my games' scope clearly separates it from siblings like yagames-search or yagames-popular.

  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 clearly states an auth prerequisite and establishes the tool is for the developer's own games. However, it does not explicitly mention when to choose this over yagames-search or other siblings, leaving the decision partly inferred from the name.

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

• yagames-publishA
  4/5.0
  Behavior3/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 adds the important requirement of auth env vars and implies a state transition from moderated to published. However, it does not disclose side effects (e.g., irreversibility, visibility changes, idempotency). For a simple one-parameter tool this is adequate though 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 a single sentence that front-loads the core action, then gives the critical precondition and authentication requirement. Every word earns its place with no redundancy or filler.

  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 one required parameter, no output schema, and no annotations, the description covers the essential aspects: what it does, when it is valid, and what environment prerequisites exist. It does not describe the result or response, but that is less critical given the simple nature of the 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 coverage is 100% and the schema already defines appId as 'Game ID'. The description does not add any additional meaning beyond connecting appId to the moderated game. This aligns with the baseline for full 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 ('Publish') and the resource ('a game'), with a specific precondition ('has passed moderation'). This distinguishes it from sibling tools like yagames-submit-moderation (submission) and yagames-update-draft (draft editing), so an agent can immediately grasp what this 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 explicitly conditions usage on the game having passed moderation, which is the key selection criterion among siblings. It does not explicitly name alternative tools for other states, but the precondition strongly implies when not to use it. This is clear context without formal exclusions.

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

• yagames-categoriesA
  4.4/5.0
  Behavior4/5

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

  With no annotations, the description carries the full burden, but 'List' clearly signals a read-only operation with no side effects, and the zero-parameter schema confirms no input requirements. It does not describe the return format or potential error conditions, which is a minor gap for such a simple catalog 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 filler. Every word contributes to explaining the tool's function, making it highly efficient.

  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 zero-parameter list operation, the description states the essential scope and behavior. It could mention the shape of the returned categories, but the tool is simple enough that an agent can call it without additional context, and no output schema exists to supply that detail.

  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 there is nothing for the description to add beyond the empty schema. The baseline for a parameterless tool is 4, and the description accurately reflects that no arguments are required.

  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 verb ('List') and resource ('all available game categories/genres on Yandex Games'), making the tool's purpose unambiguous. This clearly distinguishes it from sibling tools like yagames-search or yagames-popular, which target game search or popular content rather than categories.

  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 context: use this tool when the agent needs the full set of game categories/genres. It does not explicitly name alternatives or exclusion conditions, but no sibling directly overlaps with category listing, so the usage context is sufficient.

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