list_bundle_ids
Retrieve registered bundle IDs for your Apple Developer team to manage app identifiers, filter by platform or name, and include related resources like profiles or capabilities.
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 core handler function that executes the list_bundle_ids tool logic, making an authenticated API call to App Store Connect's /bundleIds endpoint with support for pagination, sorting, filtering, 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/types/bundles.ts:26-28 (schema)TypeScript interface defining the expected response structure for the listBundleIds tool (array of BundleId objects).export interface ListBundleIdsResponse { data: BundleId[]; }
- src/index.ts:494-536 (registration)Tool registration including name, description, and detailed input schema definition for list_bundle_ids, provided to MCP server via buildToolsList().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:1367-1368 (registration)Runtime dispatch/registration of the list_bundle_ids tool call to the BundleHandlers.listBundleIds method in the MCP CallToolRequest handler.case "list_bundle_ids": return { toolResult: await this.bundleHandlers.listBundleIds(args as any) };
- src/index.ts:76-76 (helper)Instantiation of the BundleHandlers class instance used by the list_bundle_ids tool.this.bundleHandlers = new BundleHandlers(this.client);