App Store Connect MCP Server

Instructions

Implementation Reference

• src/handlers/localizations.ts:52-69 (handler)

  The core handler function that validates the input parameters and makes an authenticated GET request to the App Store Connect API endpoint '/appStoreVersionLocalizations' to retrieve the list of localizations for the specified app store version.

  async listAppStoreVersionLocalizations(args: {
    appStoreVersionId: string;
    limit?: number;
  }): Promise<ListAppStoreVersionLocalizationsResponse> {
    const { appStoreVersionId, limit = 100 } = args;
    
    validateRequired(args, ['appStoreVersionId']);
    
    const params: Record<string, any> = {
      limit: sanitizeLimit(limit),
      'filter[appStoreVersion]': appStoreVersionId
    };
    
    return this.client.get<ListAppStoreVersionLocalizationsResponse>(
      '/appStoreVersionLocalizations',
      params
    );
  }

• src/index.ts:408-426 (schema)

  Defines the tool's name, description, and input schema for validation in the MCP tool list.

    name: "list_app_store_version_localizations",
    description: "Get all localizations for a specific app store version",
    inputSchema: {
      type: "object",
      properties: {
        appStoreVersionId: {
          type: "string",
          description: "The ID of the app store version"
        },
        limit: {
          type: "number",
          description: "Maximum number of localizations to return (default: 100)",
          minimum: 1,
          maximum: 200
        }
      },
      required: ["appStoreVersionId"]
    }
  },

• src/index.ts:1354-1355 (registration)

  Registers the tool by mapping incoming tool calls with name 'list_app_store_version_localizations' to the appropriate handler method on the LocalizationHandlers instance.

  case "list_app_store_version_localizations":
    return { toolResult: await this.localizationHandlers.listAppStoreVersionLocalizations(args as any) };

• src/types/localizations.ts:25-37 (schema)

  TypeScript interface defining the structure of the API response from listing app store version localizations.

  export interface ListAppStoreVersionLocalizationsResponse {
    data: AppStoreVersionLocalization[];
    links?: {
      self: string;
      next?: string;
    };
    meta?: {
      paging: {
        total: number;
        limit: number;
      };
    };
  }

• src/index.ts:81-82 (registration)

  Instantiates the LocalizationHandlers class with the AppStoreConnectClient, making the handler methods available for tool registration.

  this.localizationHandlers = new LocalizationHandlers(this.client);
  this.workflowHandlers = new WorkflowHandlers(this.client);