App Store Connect MCP Server

Instructions

Implementation Reference

• src/handlers/beta.ts:98-170 (handler)

  The core handler function that implements the logic for listing beta feedback screenshots. It constructs API parameters based on input args, resolves appId if bundleId is provided, and calls the App Store Connect API endpoint `/apps/{appId}/betaFeedbackScreenshotSubmissions`.
  async listBetaFeedbackScreenshots(args: ListBetaFeedbackScreenshotSubmissionsRequest): Promise<ListBetaFeedbackScreenshotSubmissionsResponse> { const { appId, bundleId, buildId, devicePlatform, appPlatform, deviceModel, osVersion, testerId, limit = 50, sort = "-createdDate", includeBuilds = false, includeTesters = false } = args; // Require either appId or bundleId if (!appId && !bundleId) { throw new Error('Either appId or bundleId must be provided'); } // If bundleId is provided but not appId, look up the app let finalAppId = appId; if (!appId && bundleId) { const app = await this.appHandlers.findAppByBundleId(bundleId); if (!app) { throw new Error(`No app found with bundle ID: ${bundleId}`); } finalAppId = app.id; } // Build query parameters const params: Record<string, any> = { limit: sanitizeLimit(limit), sort }; // Add filters if provided if (buildId) { params['filter[build]'] = buildId; } if (devicePlatform) { params['filter[devicePlatform]'] = devicePlatform; } if (appPlatform) { params['filter[appPlatform]'] = appPlatform; } if (deviceModel) { params['filter[deviceModel]'] = deviceModel; } if (osVersion) { params['filter[osVersion]'] = osVersion; } if (testerId) { params['filter[tester]'] = testerId; } // Add includes if requested const includes: string[] = []; if (includeBuilds) includes.push('build'); if (includeTesters) includes.push('tester'); if (includes.length > 0) { params.include = includes.join(','); } // Add field selections for better performance params['fields[betaFeedbackScreenshotSubmissions]'] = 'createdDate,comment,email,deviceModel,osVersion,locale,timeZone,architecture,connectionType,pairedAppleWatch,appUptimeInMilliseconds,diskBytesAvailable,diskBytesTotal,batteryPercentage,screenWidthInPoints,screenHeightInPoints,appPlatform,devicePlatform,deviceFamily,buildBundleId,screenshots,build,tester'; return this.client.get<ListBetaFeedbackScreenshotSubmissionsResponse>( `/apps/${finalAppId}/betaFeedbackScreenshotSubmissions`, params ); }
• src/index.ts:214-277 (schema)

  Tool schema definition including name 'list_beta_feedback_screenshots', description, and detailed inputSchema with all parameters, enums, and descriptions.
  name: "list_beta_feedback_screenshots", description: "List all beta feedback screenshot submissions for an app. This includes feedback with screenshots, device information, and tester comments. You can identify the app using either appId or bundleId.", inputSchema: { type: "object", properties: { appId: { type: "string", description: "The ID of the app to get feedback for (e.g., '6747745091')" }, bundleId: { type: "string", description: "The bundle ID of the app (e.g., 'com.example.app'). Can be used instead of appId." }, buildId: { type: "string", description: "Filter by specific build ID (optional)" }, devicePlatform: { type: "string", enum: ["IOS", "MAC_OS", "TV_OS", "VISION_OS"], description: "Filter by device platform (optional)" }, appPlatform: { type: "string", enum: ["IOS", "MAC_OS", "TV_OS", "VISION_OS"], description: "Filter by app platform (optional)" }, deviceModel: { type: "string", description: "Filter by device model (e.g., 'iPhone15_2') (optional)" }, osVersion: { type: "string", description: "Filter by OS version (e.g., '18.4.1') (optional)" }, testerId: { type: "string", description: "Filter by specific tester ID (optional)" }, limit: { type: "number", description: "Maximum number of feedback items to return (default: 50, max: 200)", minimum: 1, maximum: 200 }, sort: { type: "string", enum: ["createdDate", "-createdDate"], description: "Sort order for results (default: -createdDate for newest first)" }, includeBuilds: { type: "boolean", description: "Include build information in response (optional)", default: false }, includeTesters: { type: "boolean", description: "Include tester information in response (optional)", default: false } }, required: [] } },
• src/index.ts:1334-1336 (registration)

  Registration and dispatch logic in the CallToolRequestSchema handler switch statement that routes calls to the betaHandlers.listBetaFeedbackScreenshots method.
  case "list_beta_feedback_screenshots": const feedbackData = await this.betaHandlers.listBetaFeedbackScreenshots(args as any); return formatResponse(feedbackData);
• src/types/beta.ts:109-122 (schema)

  TypeScript interface defining the input parameters for the listBetaFeedbackScreenshots handler, used for type safety.
  export interface ListBetaFeedbackScreenshotSubmissionsRequest { appId?: string; bundleId?: string; buildId?: string; devicePlatform?: "IOS" | "MAC_OS" | "TV_OS" | "VISION_OS"; appPlatform?: "IOS" | "MAC_OS" | "TV_OS" | "VISION_OS"; deviceModel?: string; osVersion?: string; testerId?: string; limit?: number; sort?: "createdDate" | "-createdDate"; includeBuilds?: boolean; includeTesters?: boolean; }
• src/types/beta.ts:124-141 (schema)

  TypeScript interface defining the response structure from the App Store Connect API for beta feedback screenshots.
  export interface ListBetaFeedbackScreenshotSubmissionsResponse { data: BetaFeedbackScreenshotSubmission[]; included?: Array<{ id: string; type: string; attributes?: any; }>; links?: { self: string; next?: string; }; meta?: { paging?: { total: number; limit: number; }; }; }