get_iteration_items
Retrieve all tasks, issues, or items assigned to a specific iteration or sprint in GitHub Projects. Use this tool to view workload distribution, track progress, and manage sprint planning by fetching items linked to a particular iteration.
Instructions
Get all items assigned to a specific iteration
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| projectId | Yes | ||
| iterationId | Yes | ||
| limit | No |
Implementation Reference
- Main handler function that fetches all project items and filters those assigned to the specified iteration ID by checking field values.
async getIterationItems(data: { projectId: string; iterationId: string; limit?: number; }): Promise<{ items: Array<{ id: string; title: string; type: string; status?: string; }>; }> { try { const items = await this.listProjectItems({ projectId: data.projectId, limit: data.limit || 50 }); // Filter items that have the iteration field set to this iteration const iterationItems = items.filter((item: any) => { // Check if any field value matches the iteration ID const fieldValues = item.fieldValues || []; return fieldValues.some((fv: any) => fv.value === data.iterationId); }); return { items: iterationItems.map((item: any) => ({ id: item.id, title: item.title || 'Untitled', type: item.type, status: item.status })) }; } catch (error) { throw this.mapErrorToMCPError(error); } } - ToolDefinition including name, description, input schema (getIterationItemsSchema), and examples for the get_iteration_items tool.
export const getIterationItemsTool: ToolDefinition<GetIterationItemsArgs> = { name: "get_iteration_items", description: "Get all items assigned to a specific iteration", schema: getIterationItemsSchema as unknown as ToolSchema<GetIterationItemsArgs>, examples: [ { name: "Get iteration items", description: "Get all issues/PRs in an iteration", args: { projectId: "PVT_kwDOLhQ7gc4AOEbH", iterationId: "PVTIF_lADOLhQ7gc4AOEbH" } } ] }; - src/infrastructure/tools/ToolRegistry.ts:290-290 (registration)Registers the getIterationItemsTool in the central ToolRegistry singleton.
this.registerTool(getIterationItemsTool); - src/index.ts:494-495 (registration)MCP server dispatches call_tool requests for get_iteration_items to the ProjectManagementService handler.
case "get_iteration_items": return await this.service.getIterationItems(args); - Zod input schema validation for get_iteration_items tool parameters.
export const getIterationItemsSchema = z.object({ projectId: z.string().min(1, "Project ID is required"), iterationId: z.string().min(1, "Iteration ID is required"), limit: z.number().int().positive().default(50).optional() }); export type GetIterationItemsArgs = z.infer<typeof getIterationItemsSchema>;