apple_list_versions
Retrieve App Store version history for an app to track submissions, review status, and release states across iOS, macOS, tvOS, and visionOS platforms.
Instructions
List all App Store versions for an app
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| appId | Yes | App ID | |
| platform | No | ||
| state | No | Filter by state (e.g. PREPARE_FOR_SUBMISSION, READY_FOR_SALE) |
Implementation Reference
- src/apple/tools.ts:135-140 (handler)The handler logic for 'apple_list_versions' which performs a request to the App Store API.
handler: async (client, args) => { const params: Record<string, string> = {}; if (args.platform) params['filter[platform]'] = args.platform; if (args.state) params['filter[appStoreState]'] = args.state; return client.request(`/apps/${args.appId}/appStoreVersions`, { params }); }, - src/apple/tools.ts:130-134 (schema)Zod schema definition for 'apple_list_versions' tool inputs.
schema: z.object({ appId: z.string().describe('App ID'), platform: z.enum(['IOS', 'MAC_OS', 'TV_OS', 'VISION_OS']).optional(), state: z.string().optional().describe('Filter by state (e.g. PREPARE_FOR_SUBMISSION, READY_FOR_SALE)'), }), - src/apple/tools.ts:127-129 (registration)Tool definition and registration block for 'apple_list_versions'.
const listVersions: ToolDef = { name: 'apple_list_versions', description: 'List all App Store versions for an app',