---

name: appstore-connect description: Use when working with App Store Connect, TestFlight builds, beta testers, beta groups, or checking build review status. Covers iOS app management, TestFlight distribution, and beta testing workflows.

App Store Connect

Comprehensive App Store Connect integration for iOS app management and TestFlight beta testing.

Quick Reference

Common Workflows

Check Latest Build Status

Copy# Quick status check for an app
testflight_check_build_status(app_id="6746294071")

# Or list recent builds with details
testflight_list_builds(app_id="6746294071", limit=5)

Submit Build for Beta Review

Copy# 1. Find the build ID
testflight_list_builds(app_id="6746294071", limit=1)

# 2. Submit for review (requires approval)
testflight_submit_for_review(build_id="abc123")

# 3. Check status later
testflight_get_review_status(build_id="abc123")

Manage Beta Testers

Copy# List all testers
testflight_list_testers()

# Add a new tester
testflight_add_tester(
    email="tester@example.com",
    first_name="John",
    last_name="Doe",
    group_ids="group-id-1,group-id-2"
)

# Find tester by email
testflight_list_testers(email="tester@example.com")

Manage Beta Groups

Copy# List all groups for an app
testflight_list_groups(app_id="6746294071")

# Create external beta group
testflight_create_group(
    app_id="6746294071",
    name="Beta Testers",
    is_internal=False,
    public_link_enabled=True
)

# Add build to group (makes it available to testers)
testflight_add_build_to_group(group_id="group-123", build_ids="build-456")

# Add testers to group
testflight_add_testers_to_group(group_id="group-123", tester_ids="tester-1,tester-2")

Beta Review States

Processing States

Authentication

Uses App Store Connect API with JWT authentication. Required environment variables:

• APPSTORE_KEY_ID - API Key ID
• APPSTORE_ISSUER_ID - Issuer ID
• APPSTORE_KEY_PATH - Path to .p8 private key file

Rate Limits

App Store Connect API has rate limits. For bulk operations:

• Space requests when adding many testers
• Use pagination for large result sets (limit parameter)

Common Issues

"Build already submitted": A build can only have one active review submission. Wait for current review or use a new build.

"Tester already exists": Use testflight_list_testers(email="...") to find existing tester ID, then add to groups.

"Group not found": Use testflight_list_groups() to get valid group IDs.