App Store Connect MCP Server

Instructions

Implementation Reference

• src/handlers/workflows.ts:34-61 (handler)

  The core handler function `listWorkflows` in the `WorkflowHandlers` class that implements the tool logic by querying the App Store Connect API endpoint `/ciProducts` with sanitized parameters.

  async listWorkflows(args: {
    limit?: number;
    sort?: CiProductSortOptions;
    filter?: CiProductFilters;
    fields?: {
      ciProducts?: CiProductFieldOptions[];
    };
    include?: CiProductIncludeOptions[];
  } = {}): Promise<CiProductsResponse> {
    const { limit = 100, sort, filter, fields, include } = args;
    
    const params: Record<string, any> = {
      limit: sanitizeLimit(limit)
    };
  
    if (sort) {
      params.sort = sort;
    }
  
    if (include?.length) {
      params.include = include.join(',');
    }
  
    Object.assign(params, buildFilterParams(filter));
    Object.assign(params, buildFieldParams(fields));
  
    return this.client.get<CiProductsResponse>('/ciProducts', params);
  }

• src/index.ts:1423-1425 (registration)

  Registration of the tool handler in the MCP server's `CallToolRequestSchema` handler switch statement, mapping 'list_workflows' calls to `workflowHandlers.listWorkflows`.

  case "list_workflows":
    const workflowsData = await this.workflowHandlers.listWorkflows(args as any);
    return formatResponse(workflowsData);

• src/index.ts:852-901 (schema)

  MCP tool metadata and input schema definition for 'list_workflows' returned in the tools list response.

    name: "list_workflows",
    description: "List all App Store Connect workflows (CI products) and their associated apps",
    inputSchema: {
      type: "object",
      properties: {
        limit: {
          type: "number",
          description: "Maximum number of workflows to return (default: 100, max: 200)",
          minimum: 1,
          maximum: 200
        },
        sort: {
          type: "string",
          description: "Sort order for the results",
          enum: ["name", "-name", "productType", "-productType"]
        },
        filter: {
          type: "object",
          properties: {
            productType: {
              type: "string",
              description: "Filter by product type",
              enum: ["IOS", "MAC_OS", "TV_OS", "VISION_OS"]
            }
          }
        },
        include: {
          type: "array",
          items: {
            type: "string",
            enum: ["app", "bundleId", "primaryRepositories"]
          },
          description: "Related resources to include in the response"
        },
        fields: {
          type: "object",
          properties: {
            ciProducts: {
              type: "array",
              items: {
                type: "string",
                enum: ["name", "productType"]
              },
              description: "Fields to include for each workflow"
            }
          }
        }
      }
    }
  },

• src/types/workflows.ts:32-74 (schema)

  TypeScript type definitions for the response and parameters used in the listWorkflows handler (CiProductsResponse, CiProductFilters, etc.).

  export interface CiProductsResponse {
    data: CiProduct[];
    included?: Array<{
      id: string;
      type: "apps" | "bundleIds" | "scmRepositories";
      attributes: any;
    }>;
    links?: {
      self: string;
      first?: string;
      next?: string;
    };
    meta?: {
      paging: {
        total: number;
        limit: number;
      };
    };
  }
  
  export interface CiProductFilters {
    productType?: CiProductType;
  }
  
  export type CiProductSortOptions = 
    | "name" | "-name"
    | "productType" | "-productType";
  
  export type CiProductFieldOptions = 
    | "name"
    | "productType";
  
  export type CiProductIncludeOptions =
    | "app"
    | "bundleId" 
    | "primaryRepositories";
  
  // Build Run Types
  export interface CiBuildRun {
    id: string;
    type: "ciBuildRuns";
    attributes: {
      number: number;

• src/index.ts:82-82 (registration)

  Instantiation of the WorkflowHandlers class instance used for the workflows tools.

  this.workflowHandlers = new WorkflowHandlers(this.client);