App Store Connect MCP Server

Instructions

Implementation Reference

• src/handlers/analytics.ts:70-81 (handler)

  The handler function that lists analytics report segments by calling the App Store Connect API with the provided reportId and optional limit.

  async listAnalyticsReportSegments(args: {
    reportId: string;
    limit?: number;
  }): Promise<ListAnalyticsReportSegmentsResponse> {
    const { reportId, limit = 100 } = args;
    
    validateRequired(args, ['reportId']);
  
    return this.client.get<ListAnalyticsReportSegmentsResponse>(`/analyticsReports/${reportId}/segments`, {
      limit: sanitizeLimit(limit)
    });
  }

• src/index.ts:800-817 (schema)

  JSON schema defining the input parameters for the list_analytics_report_segments tool.

  name: "list_analytics_report_segments",
  description: "Get segments for a specific analytics report (contains download URLs)",
  inputSchema: {
    type: "object",
    properties: {
      reportId: {
        type: "string",
        description: "The ID of the analytics report"
      },
      limit: {
        type: "number",
        description: "Maximum number of segments to return (default: 100)",
        minimum: 1,
        maximum: 200
      }
    },
    required: ["reportId"]
  }

• src/index.ts:1394-1395 (registration)

  Tool registration in the CallToolRequestSchema handler switch statement, binding the tool name to the AnalyticsHandlers.listAnalyticsReportSegments method.

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

• src/types/analytics.ts:76-78 (schema)

  TypeScript interface defining the response structure for list analytics report segments.

  export interface ListAnalyticsReportSegmentsResponse {
    data: AnalyticsReportSegment[];
  }