list_analytics_reports
Retrieve available analytics reports for a specific App Store Connect report request, with options to filter by category and limit results.
Instructions
Get available analytics reports for a specific report request
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| reportRequestId | Yes | The ID of the analytics report request | |
| limit | No | Maximum number of reports to return (default: 100) | |
| filter | No |
Implementation Reference
- src/handlers/analytics.ts:50-68 (handler)The main handler function that executes the tool logic: lists analytics reports for a given report request ID using the App Store Connect API.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:1391-1392 (registration)Registers the tool handler dispatch in the MCP CallToolRequestSchema handler switch statement.case "list_analytics_reports": return { toolResult: await this.analyticsHandlers.listAnalyticsReports(args as any) };
- src/index.ts:770-797 (schema)Defines the tool metadata including name, description, and input schema for validation in the tools list.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/types/analytics.ts:72-74 (schema)TypeScript interface defining the structure of the response from the listAnalyticsReports API call.export interface ListAnalyticsReportsResponse { data: AnalyticsReport[]; }