Skip to main content
Glama

Get Review Case

get_review_case
Read-only

One cluster's review case: the representative candidate with its finding, evidence, proposed training target and independent verification; the contrasting verified success when one exists; the decision history; and a page of members. Members are paged because a cluster can hold hundreds.

Input Schema

NameRequiredDescriptionDefault
clusterIdYesCluster ID from get_adjudication_queue or get_dataset
customerIdNo(Converra superadmin only) Target customer ID
memberLimitNoMembers to return (default: 10, max: 50). membersTotal reports the full count.

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A3.5/5.0
Behavior4/5

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

Annotations already establish this is a safe, non-destructive read, so the bar is lower. The description adds real value anyway by disclosing the response shape (verification, decision history, members) and the paging behavior — members are paged because a cluster can hold hundreds — which is the kind of behavioral detail annotations do not supply.

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 resource and its contents are front-loaded in the first sentence, with a short second sentence justifying paging. It is dense but each clause names a distinct field of the returned case, so little is wasted.

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?

With no output schema, the description carries the return-value burden and does so by enumerating the case's components and explaining the paging constraint. The main remaining gap is the absence of usage/routing context for a tool whose id comes from a queue or dataset.

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 clusterId, customerId, and memberLimit are already documented, including defaults and max. The description only loosely echoes 'a page of members', adding no syntax or format detail beyond the schema, so baseline 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 clearly identifies the resource and its scope: one cluster's review case, enumerating what the case contains (representative candidate, finding, evidence, training target, verification, decision history, members). It is distinguishable from get_review_queue and get_adjudication_queue by being singular and case-focused, though it never states the retrieving verb explicitly or names those siblings.

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?

There is no when-to-use guidance or mention of alternatives. An agent is not told to call this after get_adjudication_queue or instead of get_review_queue; the only routing hint (clusterId comes from get_adjudication_queue or get_dataset) lives in the schema, not the description.

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

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources