get_sprints
Retrieve active or planned sprints for a specific part ID to track development progress and manage issue timelines in DevRev.
Instructions
Get active or planned sprints for a given part ID. Use this to get the sprints for an issue based on its part.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ancestor_part_id | Yes | The ID of the part to get the sprints for. | |
| state | No | The state of the sprints to get. When the state is not provided in query, the tool will get the active sprints. |
Implementation Reference
- src/devrev_mcp/server.py:1297-1332 (handler)Handler for the 'get_sprints' tool. Extracts ancestor_part_id and optional state (defaults to 'active'), calls DevRev API 'vistas.groups.list' with appropriate payload, and returns sprint details or error.elif name == "get_sprints": if not arguments: raise ValueError("Missing arguments") payload = {"group_object_type": ["work"]} ancestor_part_id = arguments.get("ancestor_part_id") if not ancestor_part_id: raise ValueError("Missing ancestor_part_id parameter") payload["ancestor_part"] = [ancestor_part_id] state = arguments.get("state") if not state: state = "active" payload["state"] = [state] response = make_devrev_request( "vistas.groups.list", payload ) if response.status_code != 200: error_text = response.text return [ types.TextContent( type="text", text=f"Get sprints failed with status {response.status_code}: {error_text}" ) ] sprints = response.json().get("vista_group", []) return [ types.TextContent( type="text", text=f"Sprints for '{ancestor_part_id}':\n{sprints}" ) ]
- src/devrev_mcp/server.py:446-460 (registration)Registration of the 'get_sprints' tool in the list_tools() function, defining its name, description, and JSON schema for input validation (ancestor_part_id required, state optional with enum).name="get_sprints", description="Get active or planned sprints for a given part ID. Use this to get the sprints for an issue based on its part.", inputSchema={ "type": "object", "properties": { "ancestor_part_id": {"type": "string", "description": "The ID of the part to get the sprints for."}, "state": { "type": "string", "enum": ["active", "planned"], "description": "The state of the sprints to get. When the state is not provided in query, the tool will get the active sprints." }, }, "required": ["ancestor_part_id"], }, ),
- src/devrev_mcp/server.py:448-459 (schema)Input schema for the 'get_sprints' tool, specifying properties and requirements for arguments.inputSchema={ "type": "object", "properties": { "ancestor_part_id": {"type": "string", "description": "The ID of the part to get the sprints for."}, "state": { "type": "string", "enum": ["active", "planned"], "description": "The state of the sprints to get. When the state is not provided in query, the tool will get the active sprints." }, }, "required": ["ancestor_part_id"], },