wit_list_backlogs
Retrieve backlogs for specific projects and teams in Azure DevOps using PAT authentication. Streamline project tracking and task management for enhanced productivity.
Instructions
Revieve a list of backlogs for a given project and team.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| project | Yes | The name or ID of the Azure DevOps project. | |
| team | Yes | The name or ID of the Azure DevOps team. |
Implementation Reference
- src/tools/workitems.ts:73-82 (handler)The handler function that executes the tool logic: retrieves backlogs for the given project and team using Azure DevOps WorkApi.getBacklogs() and returns JSON stringified response.
async ({ project, team }) => { const connection = await connectionProvider(); const workApi = await connection.getWorkApi(); const teamContext = { project, team }; const backlogs = await workApi.getBacklogs(teamContext); return { content: [{ type: "text", text: JSON.stringify(backlogs, null, 2) }], }; } - src/tools/workitems.ts:69-72 (schema)Zod input schema defining parameters: project (string) and team (string).
{ project: z.string().describe("The name or ID of the Azure DevOps project."), team: z.string().describe("The name or ID of the Azure DevOps team."), }, - src/tools/workitems.ts:66-83 (registration)Direct registration of the tool using McpServer.tool() call, including name, description, schema, and handler.
server.tool( WORKITEM_TOOLS.list_backlogs, "Revieve a list of backlogs for a given project and team.", { project: z.string().describe("The name or ID of the Azure DevOps project."), team: z.string().describe("The name or ID of the Azure DevOps team."), }, async ({ project, team }) => { const connection = await connectionProvider(); const workApi = await connection.getWorkApi(); const teamContext = { project, team }; const backlogs = await workApi.getBacklogs(teamContext); return { content: [{ type: "text", text: JSON.stringify(backlogs, null, 2) }], }; } ); - src/tools/workitems.ts:12-32 (helper)Constant object mapping internal names to tool names, defining 'list_backlogs' to 'wit_list_backlogs'.
const WORKITEM_TOOLS = { my_work_items: "wit_my_work_items", list_backlogs: "wit_list_backlogs", list_backlog_work_items: "wit_list_backlog_work_items", get_work_item: "wit_get_work_item", get_work_items_batch_by_ids: "wit_get_work_items_batch_by_ids", update_work_item: "wit_update_work_item", create_work_item: "wit_create_work_item", list_work_item_comments: "wit_list_work_item_comments", get_work_items_for_iteration: "wit_get_work_items_for_iteration", add_work_item_comment: "wit_add_work_item_comment", add_child_work_items: "wit_add_child_work_items", link_work_item_to_pull_request: "wit_link_work_item_to_pull_request", get_work_item_type: "wit_get_work_item_type", get_query: "wit_get_query", get_query_results_by_id: "wit_get_query_results_by_id", update_work_items_batch: "wit_update_work_items_batch", work_items_link: "wit_work_items_link", work_item_unlink: "wit_work_item_unlink", add_artifact_link: "wit_add_artifact_link", }; - src/tools.ts:24-24 (registration)High-level registration call to configureWorkItemTools within configureAllTools, which sets up all work item tools including wit_list_backlogs.
configureWorkItemTools(server, tokenProvider, connectionProvider, userAgentProvider);