Apple Developer MCP by Nova (CIVAI)

After Expo/CI has uploaded the .ipa to ASC: list builds for asc_app_id, wait until processing is VALID, attach build_id to app_store_version_id, set export compliance (uses_non_exempt_encryption usually false).

Attach an app store version or build item to an existing review submission by review_submission_id. Use after create_review_submission when building a submission manually.

Create App Store Connect app

Create ASC app bundle (may 403 if tenant allows GET only).

Create an App Store Connect API team key. Optionally downloads the one-time .p8 private key PEM (treat like a password; never commit).

Register a new bundle ID on developer.apple.com (requires Developer Identifiers session from start_browser_auth).

Create a new, empty review submission (READY_FOR_REVIEW) for an app so a version/build can be attached before submit. Use press_submit_for_review instead if you just want to submit the current version in one step.

Remove a bundle ID from developer.apple.com (requires Developer Identifiers session from start_browser_auth).

Delete empty READY_FOR_REVIEW review submission drafts (zero items) for an app. Use dry_run=true to list orphans only. Clears slots before press_submit_for_review.

Delete screenshots for targeted iPhone display types (e.g. APP_IPHONE_61 only). Use dry_run=true to list without DELETE. Requires localization_id from get_app_store_version.

Add a VALID build to TestFlight internal or external beta group. For internal, also pass tester_emails (ASC team addresses) or call invite_testflight_testers testing_scope=internal — otherwise ASC shows 0 Testers and TestFlight stays empty.

Download the one-time .p8 private key for an existing API key when canDownload is still true.

Business portal links for Agreements/Tax/Banking plus price schedule hints (contracts are human-signed).

Get one app's details (name, bundle id, SKU) by asc_app_id. Use to confirm the right app before making changes to it.

GET iOS appStoreVersions for asc_app_id

Get one build's processing state and metadata by build_id. Use before attach_build_and_compliance to confirm the build finished processing.

Get details for one existing bundle ID by its ASC resource id. Use after list_bundle_ids to confirm platform and capabilities before create_app.

Read-only checklist before Submit for Review (build, privacy, category, copyright). Includes orphan_review_submission_ids for empty drafts.

Get the Resolution Center and App Review URLs for an app, for messages Apple has not exposed via list_review_messages. Use when an operator needs to open the review thread directly in a browser.

Get the status and attached items of one review submission by review_submission_id. Use to check progress after create_review_submission.

Create or reuse an external TestFlight group, attach a processed build, enable the public join link, and return https://testflight.apple.com/join/… Requires asc_session_cookie (session_status OK). First external build may need Beta App Review before the link works for everyone.

Invite a user to your App Store Connect team (email invitation, 3-day expiry). Required for internal TestFlight when they are not already a team user. Does not replace invite_testflight_testers (external beta emails).

Add testers to a TestFlight beta group by email. testing_scope=internal: ASC team emails for Internal Testing group (required before TestFlight app shows the build). testing_scope=external: external group email invites.

List ASC app bundles (iris GET /appBundles).

List existing screenshot and app preview sets for an app store version localization (read-only). Use before upload_screenshot to see which display sizes already have assets.

List apps visible to the current App Store Connect session. Use to find an existing asc_app_id before create_app or any per-app tool.

List App Store Connect API team keys and the team issuer id (for EAS / CI). Does not return private keys.

List active App Store Connect team members and pending email invitations, returning only each person's identifier (email/username) and roles. Use before internal TestFlight distribution to confirm someone is on the team and has a TestFlight-eligible role.

List ASC builds for asc_app_id (newest first). Use before attach if operator names a build number.

List bundle IDs registered on developer.apple.com for the current team. Use to find an existing bundle_id before create_bundle_id or get_bundle_id.

Resolution Center threads and App Review messages for asc_app_id. Empty threads until Apple opens a rejection/message thread.

After operator completes Apple IDMSA in a browser, verify Developer portal session (checkPermissions).

Build already on version: create review submission and PATCH submitted=true. Requires confirm_submit_for_review=true.

PATCH app store version localization promotional text (requires asc_app_id / localization_id on tenant).

Permanently revoke an App Store Connect API team key (cannot be undone).

ASC session check

Set the app's age rating questionnaire answers (content descriptors) required before submit. Use once per app, or when content descriptors change.

Set App Privacy data-collection declarations (iris appDataUsages): pass app_privacy_profile=contact or analytics for the built-in presets, or app_privacy_profile=custom with an inline declarations JSON array when the presets don't match what the app actually collects. See SKILLS.md App Privacy section for the preset definitions.

Set primary App Store category, version copyright, and third-party content rights declaration.

PATCH build export encryption flag

Set or read USA base price tier (0 free, 1+ paid). Paid apps still need Agreements/Tax/Banking in ASC Business.

Set which build is attached to an app store version without also running export-compliance or wait-for-processing steps. Use attach_build_and_compliance instead when the build may still be processing.

Open App Store Connect sign-in only when needed. If the saved session is still valid, this tool returns success immediately and does not open the viewer. Call session_status first. Use force_reconnect only when the user explicitly wants to wipe the saved cookie and sign in again (destructive).

Upload done: attach latest/build number/build_id to current version, then press Submit for Review in ASC via API.

Operator uploaded a new build: attach latest, build_number (ASC build version), or build_id to the current store version; optionally submit for review when confirm_submit_for_review=true.

Press Submit for Review, restricted to apps on the probe/disposable allowlist (checked server-side) and gated behind confirm_probe_submit=true. For regular apps use press_submit_for_review or submit_build_and_press_submit instead; this tool exists only for automated testing against throwaway apps.

Submit a processed build for TestFlight external Beta App Review (iris betaAppReviewSubmissions). Not App Store press_submit_for_review. Fills beta app description, what to test, contact, and privacy URL when provided. Poll get_testflight_public_link until accepting_public_testers is true before sharing the join URL.

Update an existing app's name, primary locale, or bundle id (PATCH apps). Use when correcting app-level metadata after create_app.

Update the localized app name, subtitle, and privacy policy URL for one locale (PATCH app info localization). Use for text shown on the App Store listing page, not screenshots.

Create or update App Store review contact and demo sign-in for the current version (iris appStoreReviewDetail). Required before press_submit_for_review for login apps.

Update the current app store version's description, keywords, promotional text, what's new, support URL, or marketing URL for one localization (PATCH app store version localization). Use for App Store listing copy tied to a specific version, not app-level info (see update_app_info_localization).

Upload a .ipa to App Store Connect via Transporter on the replay host. For CI/Expo-built apps, upload the .ipa through Expo or your CI pipeline directly and skip this tool — it exists only for builds that must be uploaded from the replay host itself. Supply ipa_url (https) or the host-local ipa_path.

Upload one App Store screenshot into a single carousel slot via the screenshot bytes (screenshot_image_base64) or a URL to fetch them from (screenshot_image_url). Call once per slide (default size APP_IPHONE_65 / 6.5″); screenshot_file_path only works when the file already exists on the replay host's filesystem.

Upload one App Store screenshot for a single iPhone display size from a master image that this tool auto-resizes. Pass screenshot_image_base64 or screenshot_image_url when the image bytes or a fetchable URL are available; use screenshot_display_types to pick exactly one display size per call, and call again for additional sizes.

Poll until build processing VALID