work_subtasks_list
List subtasks of a work item. Create subtasks via work_create with parent_id.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| work_id | Yes | Parent work item UUID |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
List subtasks of a work item. Create subtasks via work_create with parent_id.
| Name | Required | Description | Default |
|---|---|---|---|
| work_id | Yes | Parent work item UUID |
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Changes observed during successful MCP inspections.
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full behavioral burden, and it discloses almost nothing: no ordering, pagination, or whether closed/archived subtasks are included, and no permission notes. For a no-annotation list tool this leaves real behavioral gaps, though the presence of an output schema softens the return-format omission.
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?
Two short sentences, zero filler, with the core operation stated first and the creation cross-reference second. Every clause earns its place.
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?
The output schema means return values need not be explained, and the single required parameter is covered, so the core is adequate. Still, for a list tool with no annotations, the description omits collection semantics (ordering, pagination, inclusion of closed subtasks), leaving it minimally viable rather than complete.
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 100% and the single work_id parameter is already documented as 'Parent work item UUID'. The description restates this relationship ('subtasks of a work item') but adds no format, scoping, or filtering nuance beyond the schema, so the baseline 3 for a fully documented single-param schema applies.
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 gives a specific verb and resource ('List subtasks of a work item'), so an agent immediately knows this returns the child items of a parent work item rather than the parent itself. It does not explicitly contrast with nearby listing siblings such as work_get, work_list, or work_dependencies_list, so it stops short of full sibling differentiation.
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?
The second sentence routes the agent to the correct tool for the inverse operation ('Create subtasks via work_create with parent_id'), which is useful cross-tool guidance. However, there is no explicit when-to-use/when-not guidance relative to alternatives like work_get or work_dependencies_list, so usage is only implied.
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.