App Store Connect MCP Server

Instructions

Implementation Reference

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

  The handler function that executes the tool: fetches beta feedback screenshot submissions from App Store Connect API with filtering, sorting, and optional includes.

  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:1334-1336 (registration)

  MCP tool registration: switch case that dispatches tool calls to the betaHandlers.listBetaFeedbackScreenshots method.

  case "list_beta_feedback_screenshots":
    const feedbackData = await this.betaHandlers.listBetaFeedbackScreenshots(args as any);
    return formatResponse(feedbackData);

• src/index.ts:214-277 (schema)

  MCP tool definition including name, description, and detailed inputSchema for validation.

    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/types/beta.ts:109-122 (schema)

  TypeScript interface defining the input parameters for the handler.

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