list_analytics_reports
Retrieve available analytics reports for a specific report request in App Store Connect, filtering by category and controlling result quantity.
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 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[]; }