Azure DevOps MCP Server with PAT Authentication

Instructions

Implementation Reference

• src/tools/builds.ts:104-112 (handler)

  The handler function for the 'build_get_definition_revisions' tool. It connects to Azure DevOps Build API, retrieves the revisions for the specified project and definition ID, and returns the result as JSON-formatted text content.

  async ({ project, definitionId }) => {
    const connection = await connectionProvider();
    const buildApi = await connection.getBuildApi();
    const revisions = await buildApi.getDefinitionRevisions(project, definitionId);
  
    return {
      content: [{ type: "text", text: JSON.stringify(revisions, null, 2) }],
    };
  }

• src/tools/builds.ts:100-103 (schema)

  Zod input schema defining the required parameters: 'project' (string) and 'definitionId' (number) for the tool.

  {
    project: z.string().describe("Project ID or name to get the build definition revisions for"),
    definitionId: z.number().describe("ID of the build definition to get revisions for"),
  },

• src/tools/builds.ts:98-113 (registration)

  MCP server tool registration call that associates the tool name 'build_get_definition_revisions' (via BUILD_TOOLS.get_definition_revisions), description, input schema, and handler function.

    BUILD_TOOLS.get_definition_revisions,
    "Retrieves a list of revisions for a specific build definition.",
    {
      project: z.string().describe("Project ID or name to get the build definition revisions for"),
      definitionId: z.number().describe("ID of the build definition to get revisions for"),
    },
    async ({ project, definitionId }) => {
      const connection = await connectionProvider();
      const buildApi = await connection.getBuildApi();
      const revisions = await buildApi.getDefinitionRevisions(project, definitionId);
  
      return {
        content: [{ type: "text", text: JSON.stringify(revisions, null, 2) }],
      };
    }
  );

• src/tools/builds.ts:14-14 (registration)

  Mapping of internal identifier 'get_definition_revisions' to the public tool name 'build_get_definition_revisions' within the BUILD_TOOLS constant used for registration.

  get_definition_revisions: "build_get_definition_revisions",