app-publish-mcp

Instructions

Implementation Reference

• src/apple/tools.ts:473-510 (handler)

  The handler function that executes the logic to fetch, update, or create an Apple App Store review detail record.

  handler: async (client, args) => {
    // Get existing review detail
    const existing = await client.request(
      `/appStoreVersions/${args.versionId}/appStoreReviewDetail`,
    );
  
    const reviewDetailId = existing.data?.id;
    const { versionId, ...attributes } = args;
  
    if (reviewDetailId) {
      return client.request(`/appStoreReviewDetails/${reviewDetailId}`, {
        method: 'PATCH',
        body: {
          data: {
            type: 'appStoreReviewDetails',
            id: reviewDetailId,
            attributes,
          },
        },
      });
    }
  
    // Create new
    return client.request('/appStoreReviewDetails', {
      method: 'POST',
      body: {
        data: {
          type: 'appStoreReviewDetails',
          attributes,
          relationships: {
            appStoreVersion: {
              data: { type: 'appStoreVersions', id: versionId },
            },
          },
        },
      },
    });
  },

• src/apple/tools.ts:462-472 (schema)

  Schema definition for the inputs to the apple_update_review_detail tool.

  schema: z.object({
    versionId: z.string().describe('App Store Version ID'),
    contactEmail: z.string().optional(),
    contactPhone: z.string().optional(),
    contactFirstName: z.string().optional(),
    contactLastName: z.string().optional(),
    demoAccountName: z.string().optional(),
    demoAccountPassword: z.string().optional(),
    demoAccountRequired: z.boolean().optional(),
    notes: z.string().optional().describe('Notes for the reviewer'),
  }),

• src/apple/tools.ts:459-461 (registration)

  Registration of the apple_update_review_detail tool definition.

  const updateReviewDetail: ToolDef = {
    name: 'apple_update_review_detail',
    description: 'Update app review info (contact info, notes, demo account for reviewer)',