App Store Connect MCP Server

Instructions

Implementation Reference

• src/handlers/apps.ts:8-23 (handler)

  The handler function that implements the core logic for the 'list_apps' tool. It constructs query parameters for limit and optional bundleId filter, then calls the App Store Connect API endpoint '/apps'.

  async listApps(args: { 
    limit?: number;
    bundleId?: string;
  } = {}): Promise<ListAppsResponse> {
    const { limit = 100, bundleId } = args;
    
    const params: Record<string, any> = {
      limit: sanitizeLimit(limit)
    };
    
    if (bundleId) {
      params['filter[bundleId]'] = bundleId;
    }
    
    return this.client.get<ListAppsResponse>('/apps', params);
  }

• src/index.ts:1313-1315 (registration)

  Registers the handler dispatch for the 'list_apps' tool call in the MCP server's CallToolRequestSchema handler switch statement.

  case "list_apps":
    const appsData = await this.appHandlers.listApps(args as any);
    return formatResponse(appsData);

• src/index.ts:91-104 (schema)

  Defines the tool metadata including name, description, and input schema for 'list_apps' used in the MCP tools list.

    name: "list_apps",
    description: "Get a list of all apps in App Store Connect",
    inputSchema: {
      type: "object",
      properties: {
        limit: {
          type: "number",
          description: "Maximum number of apps to return (default: 100)",
          minimum: 1,
          maximum: 200
        }
      }
    }
  },

• src/types/apps.ts:12-14 (schema)

  TypeScript interface defining the expected output structure of the list_apps tool response.

  export interface ListAppsResponse {
    data: App[];
  }