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