apple_list_builds
Retrieve uploaded App Store Connect builds for a specific app ID, with optional filtering by pre-release version and result limits.
Instructions
List builds uploaded to App Store Connect
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| appId | Yes | App ID | |
| limit | No | ||
| preReleaseVersion | No | Filter by version string |
Implementation Reference
- src/apple/tools.ts:385-393 (handler)The handler for apple_list_builds which calls the /builds endpoint on the Apple API client.
handler: async (client, args) => { const params: Record<string, string> = { 'filter[app]': args.appId, 'sort': '-uploadedDate', }; if (args.limit) params['limit'] = String(args.limit); if (args.preReleaseVersion) params['filter[preReleaseVersion.version]'] = args.preReleaseVersion; return client.request('/builds', { params }); }, - src/apple/tools.ts:380-384 (schema)The Zod schema defining the input arguments for the apple_list_builds tool.
schema: z.object({ appId: z.string().describe('App ID'), limit: z.number().optional(), preReleaseVersion: z.string().optional().describe('Filter by version string'), }), - src/apple/tools.ts:377-394 (registration)The definition of the apple_list_builds tool.
const listBuilds: ToolDef = { name: 'apple_list_builds', description: 'List builds uploaded to App Store Connect', schema: z.object({ appId: z.string().describe('App ID'), limit: z.number().optional(), preReleaseVersion: z.string().optional().describe('Filter by version string'), }), handler: async (client, args) => { const params: Record<string, string> = { 'filter[app]': args.appId, 'sort': '-uploadedDate', }; if (args.limit) params['limit'] = String(args.limit); if (args.preReleaseVersion) params['filter[preReleaseVersion.version]'] = args.preReleaseVersion; return client.request('/builds', { params }); }, };