Azure DevOps MCP Server

Instructions

Implementation Reference

• src/features/pipelines/list-pipelines/feature.ts:16-67 (handler)

  The main handler function implementing the list_pipelines tool logic by fetching pipelines via Azure DevOps Pipelines API with error handling.

  export async function listPipelines(
    connection: WebApi,
    options: ListPipelinesOptions,
  ): Promise<Pipeline[]> {
    try {
      const pipelinesApi = await connection.getPipelinesApi();
      const { projectId, orderBy, top, continuationToken } = options;
  
      // Call the pipelines API to get the list of pipelines
      const pipelines = await pipelinesApi.listPipelines(
        projectId,
        orderBy,
        top,
        continuationToken,
      );
  
      return pipelines;
    } catch (error) {
      // Handle specific error types
      if (error instanceof AzureDevOpsError) {
        throw error;
      }
  
      // Check for specific error types and convert to appropriate Azure DevOps errors
      if (error instanceof Error) {
        if (
          error.message.includes('Authentication') ||
          error.message.includes('Unauthorized') ||
          error.message.includes('401')
        ) {
          throw new AzureDevOpsAuthenticationError(
            `Failed to authenticate: ${error.message}`,
          );
        }
  
        if (
          error.message.includes('not found') ||
          error.message.includes('does not exist') ||
          error.message.includes('404')
        ) {
          throw new AzureDevOpsResourceNotFoundError(
            `Project or resource not found: ${error.message}`,
          );
        }
      }
  
      // Otherwise, wrap it in a generic error
      throw new AzureDevOpsError(
        `Failed to list pipelines: ${error instanceof Error ? error.message : String(error)}`,
      );
    }
  }

• src/features/pipelines/list-pipelines/schema.ts:7-20 (schema)

  Zod schema for input validation of the list_pipelines tool parameters (projectId, top, orderBy).

  export const ListPipelinesSchema = z.object({
    // The project to list pipelines from
    projectId: z
      .string()
      .optional()
      .describe(`The ID or name of the project (Default: ${defaultProject})`),
    // Maximum number of pipelines to return
    top: z.number().optional().describe('Maximum number of pipelines to return'),
    // Order by field and direction
    orderBy: z
      .string()
      .optional()
      .describe('Order by field and direction (e.g., "createdDate desc")'),
  });

• src/features/pipelines/tool-definitions.ts:16-20 (registration)

  ToolDefinition registration for list_pipelines, including name, description, input schema conversion, and MCP flag.

  {
    name: 'list_pipelines',
    description: 'List pipelines in a project',
    inputSchema: zodToJsonSchema(ListPipelinesSchema),
    mcp_enabled: true,

• src/features/pipelines/index.ts:68-77 (registration)

  Dispatch handler in pipelines feature that handles list_pipelines requests by parsing arguments and calling the listPipelines function.

  case 'list_pipelines': {
    const args = ListPipelinesSchema.parse(request.params.arguments);
    const result = await listPipelines(connection, {
      ...args,
      projectId: args.projectId ?? defaultProject,
    });
    return {
      content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
    };
  }

• src/features/pipelines/types.ts:10-15 (helper)

  TypeScript interface defining the options structure used by the listPipelines handler.

  export interface ListPipelinesOptions {
    projectId: string;
    orderBy?: string;
    top?: number;
    continuationToken?: string;
  }