Azure DevOps MCP Server with PAT Authentication

Instructions

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);