List prospect activity
yardstick_prospect_activities_listList bounded activity records for one Talent CRM prospect.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | ||
| request_id | No | ||
| prospect_id | Yes | ||
| starting_after | No |
yardstick_prospect_activities_listList bounded activity records for one Talent CRM prospect.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | ||
| request_id | No | ||
| prospect_id | Yes | ||
| starting_after | No |
Changes observed during successful MCP inspections.
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint=true, idempotentHint=true, and destructiveHint=false, so the safety profile is covered without the description. The description adds the constraint that the list is 'bounded', hinting at pagination semantics, but doesn't disclose ordering, response shape, or how the bound works. This matches the baseline where annotations carry the safety burden.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single front-loaded sentence with no filler. The verb and resource appear immediately. The term 'bounded' is doing deliberate work, though it could be clearer; one informative sentence is efficient without being under-specified to a fault.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With 0% schema description coverage, no output schema, and pagination parameters present, the one-sentence description is insufficient. An agent cannot determine what 'bounded' means operationally (page size semantics, cursor handling via starting_after), what activity types are returned, or what the response contains. The tool is simple but still needs more detail to be reliably invoked.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 0%, so the description must compensate for undocumented parameters. It does not explain limit, starting_after, request_id, or prospect_id beyond what the schema types show. 'Bounded' loosely maps to limit/starting_after but is never made explicit, leaving the pagination contract unclear.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
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 ('activity records for one Talent CRM prospect'), which is clear and distinguishes it from the sibling writer yardstick_prospect_activities_create. However, the adjective 'bounded' is ambiguous and no sibling is named explicitly, so it doesn't reach a 5.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
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 doesn't mention that the create counterpart should be used for writing new activity records, nor any pagination-related decision points like how to retrieve the next page. The intended usage is only implied by the verb 'List'.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Add one secure layer between your agents and this server.