App Store Connect MCP Server

Instructions

Implementation Reference

• src/handlers/analytics.ts:50-68 (handler)

  The main handler function that implements the core logic for the 'list_analytics_reports' tool. It validates inputs, builds query parameters, and calls the App Store Connect API to retrieve the list of analytics reports.

  async listAnalyticsReports(args: {
    reportRequestId: string;
    limit?: number;
    filter?: {
      category?: AnalyticsReportCategory;
    };
  }): Promise<ListAnalyticsReportsResponse> {
    const { reportRequestId, limit = 100, filter } = args;
    
    validateRequired(args, ['reportRequestId']);
  
    const params: Record<string, any> = {
      limit: sanitizeLimit(limit)
    };
  
    Object.assign(params, buildFilterParams(filter));
  
    return this.client.get<ListAnalyticsReportsResponse>(`/analyticsReportRequests/${reportRequestId}/reports`, params);
  }

• src/index.ts:770-797 (schema)

  The input schema definition for the 'list_analytics_reports' tool, registered in the MCP server's tool list. Defines parameters like reportRequestId, limit, and filter.

  name: "list_analytics_reports",
  description: "Get available analytics reports for a specific report request",
  inputSchema: {
    type: "object",
    properties: {
      reportRequestId: {
        type: "string",
        description: "The ID of the analytics report request"
      },
      limit: {
        type: "number",
        description: "Maximum number of reports to return (default: 100)",
        minimum: 1,
        maximum: 200
      },
      filter: {
        type: "object",
        properties: {
          category: {
            type: "string",
            enum: ["APP_STORE_ENGAGEMENT", "APP_STORE_COMMERCE", "APP_USAGE", "FRAMEWORKS_USAGE", "PERFORMANCE"],
            description: "Filter by report category"
          }
        }
      }
    },
    required: ["reportRequestId"]
  }

• src/index.ts:1391-1392 (registration)

  The registration of the tool handler in the MCP server's callTool request handler switch statement. Maps the tool name to the AnalyticsHandlers.listAnalyticsReports method.

  case "list_analytics_reports":
    return { toolResult: await this.analyticsHandlers.listAnalyticsReports(args as any) };

• src/types/analytics.ts:72-74 (schema)

  TypeScript interface defining the response structure for the listAnalyticsReports API call, used in the handler's return type.

  export interface ListAnalyticsReportsResponse {
    data: AnalyticsReport[];
  }