apple_submit_for_review

Instructions

Implementation Reference

• src/apple/tools.ts:517-537 (handler)

  Main handler for apple_submit_for_review. Submits an App Store version for review by POSTing to /appStoreVersionSubmissions with the versionId.

  const submitForReview: ToolDef = {
    name: 'apple_submit_for_review',
    description: 'Submit an App Store version for review',
    schema: z.object({
      versionId: z.string().describe('App Store Version ID'),
    }),
    handler: async (client, args) => {
      return client.request('/appStoreVersionSubmissions', {
        method: 'POST',
        body: {
          data: {
            type: 'appStoreVersionSubmissions',
            relationships: {
              appStoreVersion: {
                data: { type: 'appStoreVersions', id: args.versionId },
              },
            },
          },
        },
      });
    },

• src/apple/tools.ts:520-521 (schema)

  Zod schema defining the input: versionId (string) - the App Store Version ID to submit for review.

  schema: z.object({
    versionId: z.string().describe('App Store Version ID'),

• src/apple/tools.ts:1213-1252 (registration)

  Tool is exported in the appleTools array (line 1230), which is then registered in src/index.ts (line 59-74) via server.tool().

  export const appleTools: ToolDef[] = [
    // App Management
    listApps, getApp, getAppInfo, updateAppInfoCategory,
    // Bundle IDs
    listBundleIds, createBundleId,
    // Versions & Localizations
    listVersions, createVersion,
    listVersionLocalizations, createVersionLocalization, updateVersionLocalization,
    // App Info Localizations (name, subtitle)
    listAppInfoLocalizations, updateAppInfoLocalization,
    // Screenshots
    listScreenshotSets, createScreenshotSet, uploadScreenshot, deleteScreenshot,
    // Builds
    listBuilds, assignBuild,
    // Age Rating & Review Info
    getAgeRating, updateAgeRating, updateReviewDetail,
    // Submission
    submitForReview, cancelSubmission,
    // Pricing & Availability
    getAppPricing, setAppPrice, listTerritoryAvailability,
    // Customer Reviews
    listCustomerReviews, respondToReview,
    // Bundle ID Capabilities
    listBundleIdCapabilities, enableCapability, disableCapability,
    // Certificates
    listCertificates, createCertificate, revokeCertificate,
    // Provisioning Profiles
    listProfiles, createProfile, deleteProfile,
    // Devices
    listDevices, registerDevice, updateDevice,
    // TestFlight - Beta Groups
    listBetaGroups, createBetaGroup, deleteBetaGroup,
    addBetaTestersToGroup, removeBetaTestersFromGroup,
    // TestFlight - Beta Testers
    listBetaTesters, inviteBetaTester, deleteBetaTester,
    // In-App Purchases
    listIAP, createIAP, getIAP, deleteIAP,
    // Subscription Groups
    listSubscriptionGroups, createSubscriptionGroup, deleteSubscriptionGroup,
  ];

• src/apple/tools.ts:5-10 (helper)

  ToolDef interface used to define all Apple tools including submitForReview. The handler receives an AppleClient instance.

  interface ToolDef {
    name: string;
    description: string;
    schema: z.ZodObject<any>;
    handler: (client: AppleClient, args: any) => Promise<any>;
  }