list_bundle_ids
Retrieve registered bundle IDs for your Apple Developer team with filtering, sorting, and pagination options to manage app identifiers.
Instructions
Find and list bundle IDs that are registered to your team
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum number of bundle IDs to return (default: 100, max: 200) | |
| sort | No | Sort order for the results | |
| filter | No | ||
| include | No | Related resources to include in the response |
Implementation Reference
- src/handlers/bundles.ts:41-69 (handler)The handler function that lists bundle IDs by querying the App Store Connect API with filters, sorting, limits, and includes.async listBundleIds(args: { limit?: number; sort?: string; filter?: { identifier?: string; name?: string; platform?: BundlePlatform; seedId?: string; }; include?: string[]; } = {}): Promise<ListBundleIdsResponse> { const { limit = 100, sort, filter, include } = args; const params: Record<string, any> = { limit: sanitizeLimit(limit) }; if (sort) { params.sort = sort; } Object.assign(params, buildFilterParams(filter)); if (Array.isArray(include) && include.length > 0) { params.include = include.join(','); } return this.client.get<ListBundleIdsResponse>('/bundleIds', params); }
- src/index.ts:494-536 (schema)Tool schema definition including name, description, and input validation schema for list_bundle_ids.name: "list_bundle_ids", description: "Find and list bundle IDs that are registered to your team", inputSchema: { type: "object", properties: { limit: { type: "number", description: "Maximum number of bundle IDs to return (default: 100, max: 200)", minimum: 1, maximum: 200 }, sort: { type: "string", description: "Sort order for the results", enum: [ "name", "-name", "platform", "-platform", "identifier", "-identifier", "seedId", "-seedId", "id", "-id" ] }, filter: { type: "object", properties: { identifier: { type: "string", description: "Filter by bundle identifier" }, name: { type: "string", description: "Filter by name" }, platform: { type: "string", description: "Filter by platform", enum: ["IOS", "MAC_OS", "UNIVERSAL"] }, seedId: { type: "string", description: "Filter by seed ID" } } }, include: { type: "array", items: { type: "string", enum: ["profiles", "bundleIdCapabilities", "app"] }, description: "Related resources to include in the response" } } } },
- src/index.ts:1368-1369 (registration)Registers the tool handler dispatch in the MCP server request handler switch statement.return { toolResult: await this.bundleHandlers.listBundleIds(args as any) };
- src/types/bundles.ts:26-28 (schema)TypeScript interface for the response structure of listBundleIds.export interface ListBundleIdsResponse { data: BundleId[]; }