# FlightDeck — App Store Connect MCP Server # Target Audience: AI Agents & LLM Coding Assistants (Claude Desktop, Cursor, Antigravity IDE, Windsurf, Roo Code, etc.) # Canonical URL: https://kip.quest/flightdeck/llms.txt # Web Documentation: https://kip.quest/flightdeck/docs ## 1. System Role & Architecture Invariants FlightDeck is a native macOS application that hosts a local Model Context Protocol (MCP) server communicating directly with Apple's App Store Connect REST API. - **System Requirements:** macOS 12.0 (Monterey) or later. Universal Mac binary running natively on Apple Silicon and Intel Macs. - **Licensing Model:** Free download from the Mac App Store. An in-app purchase is required to unlock operational features (App Store Connect management, local MCP server, AI agent workflows, and the Approval Center). Three purchase options are available (U.S. reference pricing; regional prices and offer eligibility are displayed by Apple at purchase): Monthly subscription at $16.99/month, Annual subscription at $149.99/year with a 7-day free trial on the annual plan, and Lifetime license at $499.99 one-time purchase. - **Endpoint:** Local loopback `http://127.0.0.1:51122/mcp` (default port 51122, or custom port configured in FlightDeck Desktop) over Streamable HTTP transport. - **Credential Storage & Networking:** Private keys remain in your Mac's Keychain (`kSecClassGenericPassword`) and are used locally to sign authentication tokens (ES256, 15-minute expirations). App Store Connect API requests travel directly from your Mac to Apple over HTTPS without a FlightDeck-operated proxy. Licensing verification traffic is handled separately via Apple StoreKit and RevenueCat. - **Supported Key Types:** - *Team API Keys (Recommended):* Requires Key ID, Issuer ID, and `.p8` private key. Generated by Account Holder or Admin under Team Keys. - *Individual API Keys:* Requires Key ID and `.p8` private key (no Issuer ID). Generated under Individual Keys. Apple restricts Individual keys from accessing Sales/Finance and Provisioning endpoints. - **Apple is Authoritative:** FlightDeck has no shadow database. All reads query live Apple resources; all mutations target Apple directly. - **Usage Limits:** Zero FlightDeck request caps, metering fees, or quotas. Operations are governed solely by Apple's App Store Connect API rate limits and the developer's AI model provider token/subscription limits. - **Client Setup Assistant:** Compatible AI coding tools connect via local loopback HTTP (default: `http://127.0.0.1:51122/mcp`). FlightDeck provides an in-app setup assistant (via the "Copy Setup Prompt" button in the MCP Server view) that generates tailored connection instructions for the active AI assistant. ## 2. Safety & Governance Rules (Strict Enforcement) 1. **Always Read Before Write:** Before proposing or staging any mutation, call read tools (`apps_list`, `app_store_versions_list`, `app_store_version_localizations_list`, `release_readiness_check`) to inspect current Apple state. 2. **Dual-Layer Human-in-the-Loop & Approval Center:** - **Read Operations:** Non-destructive queries execute immediately without staging. - **Direct Mutations vs. Staged Change Sets:** When capability permission has **AI Approval: ON** (default), any mutation (POST/PATCH/DELETE) creates an immutable Staged Change Set in FlightDeck's native macOS Approval Center bound by SHA-256 fingerprints. Staged changes cannot be edited in place. - **Request Changes Feedback Loop:** If an operator requests adjustments, they click **Request Changes** and enter feedback in FlightDeck. FlightDeck returns this human feedback directly to the AI agent across MCP so the agent can interpret the feedback and propose an updated change set (automatic revision is not guaranteed). - **Immediate Writes:** Authorized write operations may execute immediately only if the operator has explicitly toggled **AI Approval: OFF** for that specific capability. - **Fail-Closed Security:** Unreviewed mutations, invalid payload hashes, or operations targeting disabled capabilities fail closed and are rejected. - **Agent Protocol:** - Report staging only when the tool result confirms staging. - Report execution only when the result confirms execution. - Report errors or uncertain outcomes accurately with the returned details. - Never infer success from an attempted call. 3. **Character Limits & Apple Invariants:** - App Name: 30 characters max. - Subtitle: 30 characters max. - Keywords: 100 characters max, comma-separated, no spaces after commas. - What's New / Description: 4,000 characters max. - Promotional Text: 170 characters max. --- ## 3. Tool Index by Capability ### Release Management - `apps_list`: List registered apps and resolve bundle IDs / Apple App IDs. - `app_store_versions_list`: List versions for an app across platforms (`IOS`, `MAC_OS`, etc.). - `app_store_version_get`: Retrieve single version details and review states. - `app_store_version_create`: Stage creation of a new release version string (e.g. `1.2.0`). - `release_readiness_check`: Run Apple submission readiness checks, flagging missing fields or unattached builds. - `release_submission_diagnostics_get`: Inspect Apple submission blockers and diagnostic codes. - `release_build_candidates`: Query processed builds valid for release attachment. - `release_build_select`: Attach a processed build candidate to a release version draft. - `release_external_prerequisites_list`: List required external acknowledgments (export compliance, ATT, EU trader). - `release_external_prerequisite_attest`: Acknowledge or attest an external release prerequisite (ITSAppUsesNonExemptEncryption). - `review_submissions_list`: List review submission packages and active review state. - `review_submission_get`: Query specific submission status (`WAITING_FOR_REVIEW`, `IN_REVIEW`, etc.). - `review_submission_create_draft`: Start a new submission draft for App Review. - `review_submission_add_app_version`: Attach the app version to the review submission draft. - `review_submission_preflight`: Run Apple's pre-submission schema and asset validation check. - `review_submission_submit`: Commit submission draft to Apple App Review. - `review_submission_cancel`: Cancel an active or waiting-for-review submission. - `review_submission_items_inspect`: Inspect all item components attached to a review submission, including reviewer rejection attachments. ### Metadata, Localization & ASO - `app_store_version_localizations_list`: List all localized release notes, descriptions, keywords for a version. - `app_store_version_localization_get`: Fetch single locale metadata (e.g. `en-US`, `de-DE`, `ja`). - `app_store_version_localization_update`: Update `description`, `keywords`, `whatsNew`, `promotionalText`, `supportUrl`, `marketingUrl`. - `app_info_localizations_list`: Query app-level global localizations. - `app_info_localization_get`: Get global localized name, subtitle, privacy policy URL. - `app_info_localization_update`: Update primary app name or 30-char subtitle. ### Binary Build & Delivery (`uploads`) - `build_upload_preview`: Inspect local `.ipa`, `.pkg`, or `.zip` binary headers, validate bundle ID, CFBundleShortVersionString, and CFBundleVersion against Apple App ID. - `build_upload_start`: Initiate binary upload stream directly to Apple App Store Connect via FlightDeck. - `build_upload_status`: Query active upload progress, chunk status, and Apple ingestion completion. - `build_upload_cancel`: Abort an in-flight binary upload session. ### TestFlight & Beta Distribution - `builds_list`: List ingested `.ipa`/`.pkg` builds, processing state (`PROCESSING`, `VALID`, `FAILED`), and build numbers. - `build_get`: Inspect build attributes, min OS, and encryption compliance flags. - `build_beta_details_get`: Retrieve internal/external beta testing details and What to Test notes. - `beta_groups_list`: List internal and external TestFlight beta groups. - `beta_group_create`: Create a new TestFlight beta group with optional public link. - `beta_group_delete`: Remove a TestFlight beta group. - `build_add_to_beta_group`: Assign a build to a beta group and publish testing notes. - `build_remove_from_beta_group`: Retract a build from a beta group immediately. ### Screenshots & Creative Assets - `app_screenshots_list`: Query uploaded screenshot sets by device display type and locale. - `app_screenshot_upload_plan`: Generate staging plan for batch asset uploads with dimension validation. - `app_screenshot_upload_execute`: Stream image bytes to Apple presigned S3 storage and commit assets. ### Pricing & Monetization - `app_price_schedule_get`: Query active and upcoming price tier schedules. - `app_price_schedule_set`: Schedule price tier changes across territories. - `app_availability_get`: List enabled international country storefronts. - `app_availability_set`: Update regional storefront availability. - `subscription_group_localizations_list`: List auto-renewable subscription group metadata. - `subscription_review_screenshot_get` / `iap_review_screenshot_get`: Check paywall review proof images. - `monetization_review_screenshot_upload`: Upload required review screenshot proof for IAP / subscriptions. ### FlightDeck Approval Center & Governance - `flightdeck_operation_stage`: Stage a single atomic API mutation in FlightDeck's approval queue. - `flightdeck_operation_stage_status`: Inspect status of a staged operation. - `flightdeck_operation_stage_cancel`: Discard a staged operation before execution. - `flightdeck_operation_execute_staged`: Execute a verified staged operation. - `flightdeck_change_set_stage`: Stage multiple related operations into an atomic batch. - `flightdeck_change_set_status`: Inspect pending change sets and diffs. - `flightdeck_change_set_cancel`: Clear staged change sets without touching Apple. - `flightdeck_change_set_execute`: Execute confirmed change set sequentially. --- ## 4. Key Prompt Patterns & Agent Operating Protocols ### 1. Release Readiness & Submission - **Readiness Check:** `release_readiness_check` + `release_submission_diagnostics_get`. - **Version Staging:** `app_store_version_create` (staged). - **Build Selection:** `release_build_candidates` $\rightarrow$ `release_build_select` (staged). - **Compliance Attestation:** `release_external_prerequisites_list` $\rightarrow$ `release_external_prerequisite_attest` (staged). - **Guidelines Audit:** `review_submission_items_inspect` + App Store Review Guidelines checks. - **Review Submission:** `review_submission_create_draft` $\rightarrow$ `review_submission_add_app_version` $\rightarrow$ `review_submission_preflight` $\rightarrow$ `review_submission_submit` (staged). - **Rejection Triage:** Inspect `review_submission_items_inspect` for reviewer rejection notes, diagnose guideline violations (e.g. 2.1 or 5.1.1), and propose exact code/metadata remediation. ### 2. Localized Metadata & ASO - **Release Notes Diff:** `app_store_version_localizations_list`. - **Changelog Sync:** Synthesize release summary into localized strings $\rightarrow$ stage `app_store_version_localization_update` calls via `flightdeck_change_set_stage`. - **Git/Fastlane Metadata Sync:** Compare local disk files (`fastlane/metadata/` or `locales/*.json`) against live records $\rightarrow$ stage atomic diff. - **ASO Keyword Optimization:** Enforce max 100 characters comma-delimited without spaces $\rightarrow$ stage via `app_store_version_localization_update`. - **App Identity:** Update 30-char name or subtitle via `app_info_localization_update`. ### 3. Binary Build, Upload & TestFlight - **Compile & Upload:** Run compiler (`xcodebuild` / `flutter build ipa` / `fastlane gym`) $\rightarrow$ run `build_upload_preview` $\rightarrow$ run `build_upload_start` $\rightarrow$ track `build_upload_status`. - **Git Changelog to TestFlight:** Run `git log [last_tag]..HEAD --oneline` $\rightarrow$ format "What to Test" notes $\rightarrow$ call `build_add_to_beta_group`. - **Processing Status:** Poll `builds_list` for `processingState == 'VALID'`. - **Beta Distribution:** Call `build_add_to_beta_group` or `beta_group_create`. ### 4. Screenshot Pipelines - **Coverage Audit:** `app_screenshots_list` across display types (`APP_IPHONE_67`, `APP_IPAD_PRO_3GEN_129`, `APP_DESKTOP`). - **Batch Upload:** `app_screenshot_upload_plan` $\rightarrow$ `app_screenshot_upload_execute`. - **Simulator Pipeline Bridge:** Scan local simulator screenshots (Fastlane Snapshot / Maestro) $\rightarrow$ sort by display size $\rightarrow$ stage upload plan. ### 5. Pricing & Monetization - **Price Schedule:** Query `app_price_schedule_get` $\rightarrow$ stage `app_price_schedule_set`. - **Territory Audit:** Query `app_availability_get`. - **Subscription Review Proof:** Check `subscription_review_screenshot_get` $\rightarrow$ stage upload with `monetization_review_screenshot_upload`. ### 6. Approval Center Governance - **Inspect Queue:** `flightdeck_change_set_status` or `flightdeck_operation_stage_status`. - **Discard Drafts:** `flightdeck_change_set_cancel` or `flightdeck_operation_stage_cancel`. - **Execute Confirmed:** `flightdeck_change_set_execute` or `flightdeck_operation_execute_staged`. ### 7. The "One-Shot Ship" (Autonomous Pipeline) Coordinates compiler binary generation, binary upload via FlightDeck (`build_upload_start`), version creation (`app_store_version_create`), localized changelog synchronization (`app_store_version_localization_update`), build linking (`release_build_select`), export compliance clearance (`release_external_prerequisite_attest`), pre-flight audit (`release_readiness_check`), and review submission draft creation (`review_submission_create_draft`). All mutations are staged in FlightDeck Approval Center for final one-click developer execution. --- ## 5. Agent Safety Checklist Before Any Execution - Did I check current state with read tools first? - Did I verify string length constraints (30 chars name/subtitle, 100 chars keywords)? - Is AI Approval enabled for this capability? If yes, will this create a staged change set? - Did I provide the developer with a clear, concise summary of exactly what will change at Apple? --- ## 6. Developer Guides & Vibe-Coding-to-App-Store Tutorials Detailed walkthroughs and step-by-step guides for developers taking AI-generated applications to the App Store: - **Developer Guides Library:** https://kip.quest/flightdeck/guides/ - **Connecting Cursor to App Store Connect via FlightDeck MCP: Complete Setup:** https://kip.quest/flightdeck/guides/connect-cursor-app-store-connect-mcp - A complete step-by-step setup guide to connecting Cursor to Apple's App Store Connect API using FlightDeck's embedded MCP server. Covers configuration, tool discovery, read-only testing, and human-in-the-loop approval. - **Diagnosing and Fixing App Store Rejections with an AI Coding Assistant:** https://kip.quest/flightdeck/guides/diagnose-fix-app-store-rejections-ai - A step-by-step developer guide to diagnosing and fixing Apple App Review rejections on vibe-coded iOS apps. Learn how to interpret App Review guidelines, reproduce crashes, fix privacy and UI issues, and submit a compliant update. - **From Vibe Coding to App Store: The Complete Step-by-Step Publishing Guide:** https://kip.quest/flightdeck/guides/from-vibe-coding-to-app-store-guide - Stage 1: AI prototyping in IDE (Cursor, Claude Code, Antigravity) - Stage 2: Apple Developer Account & API key prerequisites - Stage 3: Initial Application Record creation in App Store Connect web portal - Stage 4: Native binary compilation and code signing via xcodebuild, Flutter, or Fastlane - Stage 5: Pre-upload binary inspection via build_upload_preview - Stage 6: Direct chunked binary upload via build_upload_start - Stage 7: Apple ingestion and processing state monitoring via builds_list - Stage 8: Zero-review physical device testing with TestFlight internal groups (beta_group_create, build_add_to_beta_group) - Stage 9: External beta distribution with What to Test notes - Stage 10: Storefront metadata and 39-language localization via app_store_version_localization_update - Stage 11: Screenshot asset coverage audit and upload planning via app_screenshots_list - Stage 12: Automated pre-flight release readiness audit via release_readiness_check - Stage 13: Staged App Review submission draft and signoff via review_submission_create_draft, review_submission_add_app_version, and review_submission_submit - **Human-in-the-Loop Governance: FlightDeck Approval Center & Staged Mutations:** https://kip.quest/flightdeck/guides/human-in-the-loop-governance-flightdeck-approval-center - A complete security architecture guide to governing AI coding agents on App Store Connect. Learn how FlightDeck's native macOS Approval Center, cryptographic Change Sets, and granular capability toggles prevent unauthorized production mutations. - **Pre-Flight App Store Submission Readiness Check: Automated Audit Guide:** https://kip.quest/flightdeck/guides/pre-flight-app-store-submission-readiness-check - A comprehensive developer guide to running automated App Store submission readiness audits before submitting your iOS app to Apple App Review. Learn how to verify build linkages, screenshot coverage, localization completeness, and avoid costly review rejections. - **Uploading iOS .ipa to App Store Connect via Command Line & MCP:** https://kip.quest/flightdeck/guides/upload-ipa-to-app-store-connect-without-xcode - Learn how to upload a pre-compiled, signed iOS .ipa archive directly to App Store Connect without opening Xcode Organizer or Transporter. Covers pre-upload inspection, chunked HTTPS streaming, human approval, ingestion monitoring, and AI agent automation via MCP. - **Using Claude Code CLI with App Store Connect MCP: Terminal Workflow Guide:** https://kip.quest/flightdeck/guides/claude-code-cli-app-store-connect-mcp - A terminal-first guide to connecting Anthropic's Claude Code CLI to Apple App Store Connect via FlightDeck's local MCP server. Configure Streamable HTTP transport, verify tool discovery, run read-only queries, and safely stage release mutations. - **FlightDeck Architecture: Local Loopback MCP Server and Direct Apple API:** https://kip.quest/flightdeck/guides/flightdeck-architecture-local-mcp-server-apple-api - Understand FlightDeck's security and communication architecture: local Streamable HTTP MCP loopback, macOS Keychain encryption, direct Apple REST API integration, and the native Approval Center. - **Five App Review Rejection Risks for AI Apps (Pre-Submission Checklist):** https://kip.quest/flightdeck/guides/top-app-store-rejections-vibe-coded-apps - A pre-submission audit checklist for vibe coders covering common practical Apple App Review rejection risks and how to verify your build before submitting. - **App Store Connect API Keys Guide: Generating Team Keys for AI Agents:** https://kip.quest/flightdeck/guides/app-store-connect-api-key-ai-agent-setup - A complete step-by-step developer guide to generating Apple App Store Connect API keys for AI coding agents. Learn key requirements, role permissions, macOS Keychain storage, and how to safely connect tools like Cursor and Claude Code without leaking your private key. - **Automating App Store Multi-Language Localization and What's New via AI:** https://kip.quest/flightdeck/guides/automate-app-store-localization-whats-new-ai - Learn how to use an AI coding assistant and FlightDeck to draft, translate, and update App Store descriptions, keywords, subtitles, and What's New release notes across multiple languages safely under human approval. - **Automating TestFlight Beta Distribution from Your AI Coding Assistant:** https://kip.quest/flightdeck/guides/automate-testflight-beta-distribution-ai-agent - A complete guide to distributing iOS beta builds to internal and external testers using your AI coding assistant. Learn how to verify build ingestion, manage TestFlight beta groups, handle export compliance, and navigate Beta App Review via FlightDeck. - **Creating and Submitting an App Review Draft via FlightDeck MCP:** https://kip.quest/flightdeck/guides/create-submit-app-review-draft-mcp - A complete step-by-step guide to preparing, preflighting, and submitting an App Store version to Apple App Review using your AI coding assistant and FlightDeck MCP. - **Testing on Physical iPhone Without Cables: TestFlight Internal Testing Guide:** https://kip.quest/flightdeck/guides/test-vibe-coded-app-on-iphone-without-cable - Learn how to test your Cursor or Claude Code AI-generated iOS app on a physical iPhone without USB cables. Compare Xcode wireless deployment, free Apple accounts, and TestFlight internal testing via FlightDeck. - **Selecting a TestFlight Build for an App Store Release Version:** https://kip.quest/flightdeck/guides/link-testflight-build-app-store-release-version - How to associate and link a validated TestFlight build to your App Store release version using natural-language prompts with your AI coding assistant and FlightDeck. - **Zero-Relay Privacy Guarantee: How FlightDeck Connects Directly to Apple:** https://kip.quest/flightdeck/guides/zero-relay-privacy-guarantee-direct-apple-connection - Why FlightDeck uses a zero-relay architecture, how network requests travel directly from your Mac to Apple without intermediary cloud servers, and how to verify traffic locally. - **Can AI Publish to the App Store Without Xcode? Workflow Boundaries Explained:** https://kip.quest/flightdeck/guides/can-ai-publish-to-app-store-without-xcode - A technical breakdown of whether AI coding assistants can publish iOS apps without Xcode, separating the Xcode graphical IDE from Apple's CLI toolchain, cloud builds, and FlightDeck MCP. - **Why Is My TestFlight Build Stuck on Processing? Causes and Fixes:** https://kip.quest/flightdeck/guides/fix-testflight-build-stuck-processing - Understand why iOS builds get stuck in Processing or disappear from TestFlight, how to diagnose failures with FlightDeck MCP, and how to recover. - **From 'flutter build ipa' to App Store Connect: Automated Pipeline:** https://kip.quest/flightdeck/guides/flutter-build-ipa-to-app-store-connect - A complete step-by-step guide to taking your Flutter release build from 'flutter build ipa' directly into App Store Connect and TestFlight using your AI coding assistant and FlightDeck MCP. - **Prompt Engineering for App Store Connect: 10 Essential Agent Prompts:** https://kip.quest/flightdeck/guides/prompt-engineering-app-store-connect-mcp - Master prompt patterns for managing App Store Connect with AI coding agents like Claude Code, Cursor, and Gemini via FlightDeck MCP. - **Sharing Your Pre-Release App with Friends: TestFlight External Testing Setup:** https://kip.quest/flightdeck/guides/share-ios-app-with-friends-testflight - Learn how to share your pre-release iOS app with friends, colleagues, and external testers using TestFlight public links and email invitations via FlightDeck. - **From Git Commits to App Store 'What's New': Automated Release Notes:** https://kip.quest/flightdeck/guides/sync-git-commits-to-app-store-whats-new - A complete step-by-step developer guide to converting Git commit histories into customer-friendly, compliant App Store 'What's New' release notes using an AI coding assistant and FlightDeck MCP. - **Execution vs Staging Rules: What AI Operations Require Human Approval:** https://kip.quest/flightdeck/guides/execution-vs-staging-rules-ai-operations-approval - Understand FlightDeck's safety model: learn which operations execute immediately, why mutating actions are staged, and how the Desktop Approval Center keeps you in control. - **Export Compliance & Encryption Attestation Guide (ITSAppUsesNonExemptEncryption):** https://kip.quest/flightdeck/guides/export-compliance-encryption-attestation-guide - A comprehensive developer guide to U.S. export compliance, encryption exemptions, ITSAppUsesNonExemptEncryption in Info.plist, and App Store Connect compliance attestations. - **Fixing 'Missing ITSAppUsesNonExemptEncryption' in iOS Info.plist:** https://kip.quest/flightdeck/guides/fix-missing-encryption-key-itsappusesnonexemptencryption - Understand Apple's export compliance requirements, resolve 'Missing Compliance' warnings in TestFlight, determine exempt vs non-exempt encryption, and configure ITSAppUsesNonExemptEncryption correctly. - **Keychain Storage and Token Signing: Protecting App Store Connect Credentials:** https://kip.quest/flightdeck/guides/keychain-storage-token-signing-security - How FlightDeck protects App Store Connect .p8 private keys using the macOS Keychain, in-memory ES256 JWT signing, and ephemeral local Bearer tokens without exposing secrets to AI models. - **The Autonomous 'One-Shot Ship' Workflow: Pipeline Orchestration via MCP:** https://kip.quest/flightdeck/guides/autonomous-one-shot-ship-workflow-mcp - How to orchestrate a structured, multi-step App Store release pipeline using MCP tools while preserving human governance and handling Apple's asynchronous processing. - **Bulk Uploading App Store Screenshots via MCP: Automating Display Sets:** https://kip.quest/flightdeck/guides/bulk-upload-app-store-screenshots-mcp - Learn how to plan, stage, and execute bulk App Store screenshot uploads across iPhone and iPad display sizes using your AI coding assistant and FlightDeck MCP. - **Compiling and Code-Signing iOS Apps via xcodebuild CLI: Complete Guide:** https://kip.quest/flightdeck/guides/compile-export-signed-ipa-xcodebuild-cli - A complete developer guide to compiling, archiving, and exporting signed iOS IPA packages from the command line using xcodebuild, with post-export pre-upload inspection. - **Fixing Guideline 2.2 Rejections: Removing Prohibited Beta Keywords & Placeholders:** https://kip.quest/flightdeck/guides/fix-guideline-2-2-beta-references-metadata - Resolve Apple App Review Guideline 2.2 rejections by auditing metadata, eliminating beta references, removing placeholder UI, and submitting compliant updates. - **Fixing ITMS-90034, ITMS-90035, and Code-Signing Errors on App Store Upload:** https://kip.quest/flightdeck/guides/fix-itms-90034-invalid-signature-upload-error - Resolve App Store Connect upload error ITMS-90034 (Missing or Invalid Signature), ITMS-90035, and provisioning profile mismatches when uploading iOS IPAs. - **The 'Request Changes' Feedback Loop: Guiding AI Revisions Across MCP:** https://kip.quest/flightdeck/guides/request-changes-feedback-loop-ai-revisions-mcp - How the Request Changes workflow in FlightDeck Desktop allows developers to steer AI coding assistants with structured feedback without executing unwanted App Store mutations. - **Configuring App Store Price Schedules and Free Tiers via MCP:** https://kip.quest/flightdeck/guides/configure-app-store-price-schedules-free-tier - How to inspect base price schedules, configure paid tiers, or transition your iOS app to Free using FlightDeck MCP with AI-assisted safety controls. - **Resolving Guideline 2.1 Rejections: Broken Links, Incomplete Features, and Demo Credentials:** https://kip.quest/flightdeck/guides/fix-guideline-2-1-app-completeness-rejection - Diagnose and resolve App Store Review rejections under Guideline 2.1 (App Completeness), covering demo account requirements, backend connectivity, and submission fixes. - **FlightDeck MCP Capability Index: What Your AI Assistant Can Do:** https://kip.quest/flightdeck/guides/flightdeck-mcp-tool-reference-capability-index - A comprehensive developer capability index for FlightDeck's semantic MCP tools across 10 functional domains, detailing read-only queries, staged mutations, approval requirements, and prompt recipes. - **Generating TestFlight 'What to Test' Notes from Git Commits via AI:** https://kip.quest/flightdeck/guides/generate-testflight-what-to-test-notes-git-ai - A complete guide to transforming local Git commit histories into concise, tester-ready TestFlight 'What to Test' release notes using your AI coding assistant and FlightDeck MCP. - **Auditing In-App Purchases and Subscription Groups with an AI Agent:** https://kip.quest/flightdeck/guides/inspect-in-app-purchases-subscriptions-ai-agent - Learn how to use an AI coding assistant and FlightDeck MCP to inspect In-App Purchases, auto-renewable subscriptions, pricing, localizations, and review readiness. - **Pre-Upload Binary Inspection: How FlightDeck Validates .ipa Files:** https://kip.quest/flightdeck/guides/pre-upload-binary-validation-checks-ipa - Understand the local pre-upload checks FlightDeck performs on iOS .ipa packages to prevent failed uploads, Transporter errors, and processing rejections. - **Uploading React Native and Expo IPAs to App Store Connect with AI:** https://kip.quest/flightdeck/guides/react-native-expo-ipa-upload-app-store-connect - A complete guide to packaging bare React Native or Expo EAS builds into signed .ipa binaries and uploading them directly to App Store Connect via FlightDeck MCP. - **Team API Keys vs Individual API Keys: Permissions and Setup Guide:** https://kip.quest/flightdeck/guides/team-vs-individual-api-keys-app-store-connect - Understand the differences between Team Keys and Individual Keys in App Store Connect, their permission boundaries, and how to configure them for FlightDeck. - **Configuring FlightDeck MCP with Antigravity IDE, Windsurf, and Roo Code:** https://kip.quest/flightdeck/guides/antigravity-windsurf-roo-code-mcp-flightdeck - Connect Google Antigravity IDE, Windsurf, and Roo Code to App Store Connect using FlightDeck's local Model Context Protocol server. - **App Store Keyword Optimization (ASO) with AI: Maximizing Your 100 Characters:** https://kip.quest/flightdeck/guides/app-store-keyword-optimization-aso-ai - A practical developer guide to optimizing Apple's 100-character App Store keyword field using an AI coding assistant and FlightDeck MCP without violating App Store Review Guidelines. - **App Store Metadata Character Limits: Rules for Names, Subtitles, and Keywords:** https://kip.quest/flightdeck/guides/app-store-metadata-character-limits-rules - Authoritative reference for Apple App Store character limits across titles, subtitles, descriptions, keywords, promotional text, and release notes. - **Creating App Store Screenshots: Required Sizes, Formats, and Automated Uploads:** https://kip.quest/flightdeck/guides/app-store-screenshot-sizes-automated-upload - A complete beginner-friendly developer guide to capturing simulator screenshots, preparing App Store display sets, validating formats, and automating uploads via FlightDeck MCP. - **App Store Screenshot Sizes: Complete Dimension Guide for iPhone and iPad:** https://kip.quest/flightdeck/guides/app-store-screenshot-sizes-dimensions-guide - Master Apple's App Store screenshot dimensions, display sets, accepted formats, scaling rules, and automated upload workflows for iPhone and iPad apps. - **Checking App Store Connect Build Processing State via Natural Language:** https://kip.quest/flightdeck/guides/check-app-store-connect-build-processing-state-ai - How to use FlightDeck MCP with natural-language AI prompts to check build processing status, export compliance, and TestFlight eligibility in App Store Connect. - **macOS Keychain Integration: Securing .p8 Private Keys via kSecClassGenericPassword:** https://kip.quest/flightdeck/guides/macos-keychain-integration-securing-p8-keys - How FlightDeck leverages the native Apple Security framework, kSecClassGenericPassword, and standard-input streaming to protect App Store Connect .p8 keys from AI tool leakage and process snooping. - **TestFlight Beta App Review Rejections: Common Causes and Rapid Fixes:** https://kip.quest/flightdeck/guides/testflight-beta-app-review-rejections-fixes - Learn why Apple rejects pre-release builds during TestFlight Beta App Review, how to fix common blockers, and how to distribute approved builds via your AI assistant. - **Uploading In-App Purchase Review Screenshots via FlightDeck MCP:** https://kip.quest/flightdeck/guides/upload-iap-review-proof-screenshots-mcp - Learn how to resolve 'Missing Metadata' on In-App Purchases and subscriptions by uploading App Review proof screenshots with FlightDeck MCP. - **Atomic Change Sets: Preventing Partial and Broken App Store Connect Mutations:** https://kip.quest/flightdeck/guides/atomic-change-sets-preventing-broken-mutations - How FlightDeck batches App Store Connect mutations, how sequential execution and immediate halt-on-failure protect your account, and how to manage partial-update risks. - **Auditing AI Actions: Inspecting FlightDeck Operation Logs and Diffs:** https://kip.quest/flightdeck/guides/auditing-ai-actions-flightdeck-operation-logs - How to inspect, query, and verify the append-only local audit log of all App Store Connect mutations and read operations triggered by AI assistants in FlightDeck. - **Configuring Free Trials and Introductory Offers on iOS Subscriptions:** https://kip.quest/flightdeck/guides/configure-free-trials-introductory-offers-subscriptions - How to configure free trials, pay-as-you-go, and pay-up-front introductory offers on auto-renewable subscriptions in App Store Connect, stage API changes via FlightDeck, and verify StoreKit 2 eligibility. - **iOS App Store Shipping Checklist: Prerequisites for AI-Generated Apps:** https://kip.quest/flightdeck/guides/ios-app-store-shipping-checklist-ai-apps - A complete 16-point interactive shipping checklist for vibe coders and AI developers taking an iOS app from prototype to App Store release. Clearly distinguishes build tools, portal prerequisites, and FlightDeck MCP automation. - **Shipping Version 1.1: Managing App Store Updates and Changelogs via AI:** https://kip.quest/flightdeck/guides/shipping-app-store-updates-changelogs-ai - The complete step-by-step developer guide to shipping an app update: creating draft versions, attaching builds, updating localized What's New changelogs, and submitting for App Review via FlightDeck MCP. - **TestFlight Processing Time: How Long Does Apple Take to Process Builds?:** https://kip.quest/flightdeck/guides/testflight-processing-time-apple-builds - An evidence-based guide explaining Apple TestFlight build processing times, automated ingestion stages, why processing times vary, and how to diagnose stuck builds using FlightDeck MCP. - **Testing StoreKit In-App Purchases and Subscriptions in TestFlight (Sandbox):** https://kip.quest/flightdeck/guides/testing-in-app-purchases-subscriptions-testflight-sandbox - A comprehensive developer guide to testing StoreKit 2 in-app purchases, subscriptions, accelerated renewal schedules, and restore flows in Apple's TestFlight sandbox. - **Writing Effective App Review Notes: Demo Accounts and Reviewer Guidance:** https://kip.quest/flightdeck/guides/writing-effective-app-review-notes-demo-accounts - Prepare clear App Review notes, provide reliable demo credentials, avoid MFA pitfalls, and guide Apple reviewers through complex features. - **App Store Version vs Build Numbering Rules for Automated Pipelines:** https://kip.quest/flightdeck/guides/app-store-version-build-number-rules - Master CFBundleShortVersionString and CFBundleVersion rules for App Store Connect, TestFlight, and automated CI/CD and AI agent build pipelines. - **How to Create a TestFlight Public Link for Community Beta Testing:** https://kip.quest/flightdeck/guides/create-testflight-public-link-beta-testing - A complete developer guide to configuring, sharing, and managing TestFlight public invitation links using FlightDeck MCP. Learn eligibility rules, Beta App Review gates, quota caps, and disabling procedures. - **Direct Apple Asset Delivery: Security Architecture of FlightDeck Binary Uploads:** https://kip.quest/flightdeck/guides/direct-apple-asset-delivery-security-architecture - A technical examination of Apple's App Store Connect binary upload architecture and the zero-intermediary security design implemented by FlightDeck. - **Managing TestFlight Internal and External Beta Groups via MCP:** https://kip.quest/flightdeck/guides/manage-testflight-beta-groups-mcp - A complete developer guide to creating, organizing, and managing TestFlight beta testing groups using FlightDeck MCP. Learn how to configure internal vs external cohorts, attach builds, set public links, and safely delete obsolete groups. - **TestFlight vs App Store Release: When and How to Distribute Your App:** https://kip.quest/flightdeck/guides/testflight-vs-app-store-release-differences - Understand the differences between TestFlight beta distribution and a public App Store release: audience quotas, review requirements, 90-day build expiration, StoreKit sandbox testing, and AI prompt workflows. - **How to Retract or Expire a Broken TestFlight Build Immediately:** https://kip.quest/flightdeck/guides/expire-delete-broken-testflight-build - Learn how to immediately expire a broken TestFlight build or retract it from beta testing groups to prevent tester crashes and bug reports. - **Guideline 5.1.1 Compliance: Implementing In-App Account Deletion:** https://kip.quest/flightdeck/guides/guideline-5-1-1-in-app-account-deletion - A complete implementation and compliance guide to App Store Review Guideline 5.1.1(v), covering in-app deletion UI, Sign in with Apple token revocation, and App Review notes. - **Syncing Fastlane Metadata Files to App Store Connect via FlightDeck:** https://kip.quest/flightdeck/guides/sync-fastlane-metadata-files-app-store-connect - How to parse local Fastlane metadata directories and synchronize localized descriptions, keywords, and release notes to App Store Connect with an AI assistant and FlightDeck MCP. - **Troubleshooting FlightDeck MCP Connection Errors: ECONNREFUSED and Port Conflicts:** https://kip.quest/flightdeck/guides/troubleshooting-mcp-connection-errors-flightdeck - Diagnose and resolve connection failures between AI coding assistants (Cursor, Claude Code, Antigravity, Windsurf, Roo Code) and FlightDeck's local MCP server. Covers port conflicts, transport mismatches, and authentication. - **App Store Privacy Nutrition Labels: What AI Developers Need to Declare:** https://kip.quest/flightdeck/guides/app-store-privacy-nutrition-labels-guide - A complete guide to completing Apple's App Privacy questionnaire for apps built with AI coding assistants, covering SDK data collection, privacy manifests, and store disclosures. - **Deploying Cross-Platform Apps (Flutter/React Native) to TestFlight:** https://kip.quest/flightdeck/guides/deploy-flutter-react-native-testflight - A comprehensive guide to packaging, uploading, and distributing Flutter and React Native iOS applications to TestFlight testers using FlightDeck MCP. - **Using Fastlane and FlightDeck Together: Compilation vs API Automation:** https://kip.quest/flightdeck/guides/fastlane-and-flightdeck-integration-pipeline - How to combine Fastlane's build and code-signing automation with FlightDeck's conversational App Store Connect management and approval governance. - **Fixing 'Screenshots Cannot Contain Alpha Channels' Error in App Store Connect:** https://kip.quest/flightdeck/guides/fix-screenshots-cannot-contain-alpha-channels - A complete troubleshooting guide to diagnosing and stripping alpha transparency channels from App Store screenshots using ImageMagick, native macOS utilities, and Python before uploading. - **FlightDeck Licensing & API Quotas: Zero Per-Call Metering Explained:** https://kip.quest/flightdeck/guides/flightdeck-licensing-api-quotas-zero-metering - How FlightDeck's local desktop licensing works, why there are zero per-call fees or AI token quotas, and how costs break down across Apple and your AI provider. - **Managing App Store Territory Availability and Regional Restrictions via MCP:** https://kip.quest/flightdeck/guides/manage-app-store-territory-availability - Inspect where your iOS app is available, configure worldwide distribution, or adjust country restrictions using natural-language AI prompts and FlightDeck. - **Previewing App Store Storefront Copy and Localizations Before Submission:** https://kip.quest/flightdeck/guides/preview-app-store-storefront-copy-before-submission - A comprehensive developer guide to auditing and previewing your App Store storefront copy, localized descriptions, and metadata completeness with an AI agent and FlightDeck MCP prior to App Review. - **Fail-Closed Security Model: How FlightDeck Handles Invalid or Disabled Operations:** https://kip.quest/flightdeck/guides/fail-closed-security-model-flightdeck - How FlightDeck's defense-in-depth security architecture enforces fail-closed boundaries across MCP transport, capability policies, cryptographic tokens, and network failures. - **Individual vs Team API Key Restrictions on Sales and Financial Endpoints:** https://kip.quest/flightdeck/guides/individual-vs-team-api-key-sales-finance-restrictions - Why Apple restricts Individual API keys from accessing sales and financial reporting endpoints, how Team API keys resolve HTTP 403 Forbidden errors, and what FlightDeck can diagnose. - **How to Create an App Record and Reserve Your Name in App Store Connect:** https://kip.quest/flightdeck/guides/reserve-app-name-bundle-id-app-store-connect - Claim your app name, register an Explicit Bundle ID, configure SKUs, and establish an App Store Connect app record before writing code or uploading your first build. - **Uploading macOS Applications (.pkg) to the Mac App Store via MCP:** https://kip.quest/flightdeck/guides/upload-macos-pkg-mac-app-store-mcp - A comprehensive developer guide to packaging, sandboxing, and uploading macOS .pkg installer packages to the Mac App Store using FlightDeck MCP. - **Appealing App Store Rejections: Resolution Center Communication Guide:** https://kip.quest/flightdeck/guides/appealing-app-store-rejections-resolution-center - A professional framework for diagnosing App Store Review rejections, crafting factual Resolution Center responses, distinguishing clarifications from formal appeals, and knowing when a new build is required. - **Canceling Staged Operations in FlightDeck: Zero-Impact Queue Discarding:** https://kip.quest/flightdeck/guides/canceling-staged-operations-flightdeck-zero-impact - How to safely discard pending staged operations and Change Sets in FlightDeck via MCP or the Desktop Approval Center without touching Apple's servers. - **FlightDeck Desktop vs Headless CI/CD: Understanding Local Desktop Architecture:** https://kip.quest/flightdeck/guides/flightdeck-desktop-vs-headless-cicd-github-actions - Why FlightDeck is architected as an interactive macOS desktop application, why headless CI/CD daemons are unsupported, and how to combine GitHub Actions with local FlightDeck governance. - **Collecting TestFlight Crash Logs and Tester Feedback with Your AI Agent:** https://kip.quest/flightdeck/guides/collect-testflight-crash-logs-feedback-ai - A practical guide to collecting, locating, interpreting, and debugging TestFlight crash reports, feedback screenshots, and tester comments using an AI coding assistant. - **Multi-Account Management in FlightDeck: Switching Apple Developer Teams:** https://kip.quest/flightdeck/guides/multi-account-management-flightdeck-developer-teams - How to manage multiple Apple Developer teams and client accounts in FlightDeck using isolated Connection Profiles, Keychain-backed credentials, and safe account-switching workflows. - **Scheduling Future App Store Price Changes via API Price Schedules:** https://kip.quest/flightdeck/guides/scheduling-future-app-store-price-changes - How to schedule future price changes, promotional discounts, and territory adjustments using App Store Connect API Price Schedules and FlightDeck MCP without keeping your computer online. - **StoreKit 2 & RevenueCat Architecture: Anonymous Licensing Verification:** https://kip.quest/flightdeck/guides/storekit-2-revenuecat-licensing-architecture - How modern iOS applications separate App Store Connect configuration, client-side StoreKit 2 purchases, and anonymous backend receipt verification like RevenueCat, and how FlightDeck dogfoods this architecture. - **Tracking App Store Upload Progress and Chunk Status in Real Time:** https://kip.quest/flightdeck/guides/tracking-app-store-upload-progress-chunks - How to track App Store binary upload progress, understand multipart chunking, diagnose network interruptions, and check container processing states. - **Can Any Tool Guarantee App Store Approval? Review Safety Reality:** https://kip.quest/flightdeck/guides/can-tools-guarantee-app-store-approval-reality - A candid technical examination of what automated App Store readiness checks can and cannot verify, why no tool can guarantee Apple approval, and how FlightDeck eliminates preventable rejections. - **Apple Developer Program & App Store Publishing Costs Explained:** https://kip.quest/flightdeck/guides/cost-to-publish-ios-app-apple-developer-pricing - A complete, beginner-friendly cost breakdown of publishing an iOS app on the App Store, from the mandatory $99/year Apple Developer fee to commissions, hardware, and hosting options. - **Deleting App Store Screenshots Safely via MCP Tooling:** https://kip.quest/flightdeck/guides/delete-app-store-screenshots-safely-mcp - A complete developer guide to safely identifying, previewing, and deleting outdated App Store screenshots via FlightDeck operation staging without accidental asset loss. - **iOS Code Signing Explained: Development vs Ad-Hoc vs App Store Distribution:** https://kip.quest/flightdeck/guides/ios-code-signing-development-adhoc-distribution - A comprehensive guide to iOS code signing, distinguishing Development, Ad Hoc, and App Store certificates, provisioning profiles, entitlements, and safe inspection methods. - **Multi-Track TestFlight Testing: Staging Alpha, QA, and Public Beta Builds:** https://kip.quest/flightdeck/guides/multi-track-testflight-testing-alpha-qa-beta - A complete architectural and operational guide to implementing multi-track distribution (Alpha, QA, Staging, and Public Beta) in Apple TestFlight using FlightDeck MCP. - **App Store Review Times in 2026: What to Expect and How to Expedite:** https://kip.quest/flightdeck/guides/app-store-review-times-2026-turnaround - A realistic breakdown of App Store Review turnaround times in 2026, typical review lifecycle stages, common delay triggers, expedited review criteria, and what FlightDeck can inspect. - **Canceling an App Store Review Submission in Flight or Draft:** https://kip.quest/flightdeck/guides/cancel-withdraw-app-store-review-submission - A comprehensive guide to safely canceling or withdrawing an App Store Review submission in flight or draft, understanding state transitions, preserving metadata, and re-submitting. - **Do You Need a Mac to Publish an iOS App? Hardware & Cloud Options:** https://kip.quest/flightdeck/guides/do-you-need-a-mac-to-publish-ios-app - A comprehensive guide explaining which parts of iOS app creation require macOS, how Windows and Linux developers publish using cloud build services, and where FlightDeck fits in. - **Handling App Store Connect Rate Limits and Exponential Backoff via MCP:** https://kip.quest/flightdeck/guides/handling-app-store-connect-rate-limits-mcp - How Apple enforces App Store Connect API rate limits, how FlightDeck's token-bucket rate limiter and jittered exponential backoff prevent bans, and how to structure AI agent batch workflows. - **Managing TestFlight Testers: Adding, Inviting, and Revoking Access:** https://kip.quest/flightdeck/guides/managing-testflight-testers-inviting-revoking - A comprehensive developer guide to inviting, managing, and revoking TestFlight beta testers using FlightDeck MCP. Learn the 3-tier blast radius of tester removal, privacy protections, and invitation workflows. - **App Store Promotional Text Explained: When and How to Update It:** https://kip.quest/flightdeck/guides/app-store-promotional-text-explained - A complete guide to App Store Promotional Text: how it differs from your description, why it can be edited anytime without App Review, and how to update it via FlightDeck MCP. - **Configuring App Store Primary and Secondary Categories via MCP:** https://kip.quest/flightdeck/guides/configure-app-store-primary-secondary-categories - A complete guide to configuring Primary and Secondary App Store categories for iOS and macOS applications, explaining API relationships, review implications, and FlightDeck operation staging. - **Fixing 'Untrusted Developer' and iOS Provisioning Installation Errors:** https://kip.quest/flightdeck/guides/fix-untrusted-developer-ios-provisioning-error - A step-by-step diagnostic guide to resolving 'Untrusted Developer', provisioning profile mismatches, and device installation errors across Xcode, Ad Hoc, and TestFlight. - **Apple Paid Applications Agreement: Banking, Tax, and Legal Requirements:** https://kip.quest/flightdeck/guides/apple-paid-applications-agreement-banking-tax - The complete guide to accepting Apple's Paid Applications Agreement, configuring banking details and tax forms (W-9 / W-8BEN), and understanding what requires Apple's web portal vs. FlightDeck MCP. - **Reordering App Store Screenshot Sequences via MCP Tooling:** https://kip.quest/flightdeck/guides/reordering-app-store-screenshots-mcp - How to inspect and reorder App Store screenshot sequences using FlightDeck's operation staging and Apple's relationship API without deleting or re-uploading assets. - **TestFlight Limits: Internal vs External Tester Quotas and Build Expiration:** https://kip.quest/flightdeck/guides/testflight-tester-limits-internal-external - A complete reference guide to Apple TestFlight tester limits, internal vs external cohort quotas, public link caps, build expiration clocks, and account-level restrictions. - **Apple Small Business Program: 15% vs 30% Fee Breakdown for Indie Developers:** https://kip.quest/flightdeck/guides/apple-small-business-program-fee-breakdown - How the Apple Small Business Program reduces App Store commission from 30% to 15%, who qualifies under the $1M proceeds threshold, Associated Developer Account rules, and enrollment steps. - **TestFlight Build Expiration: 90-Day Limits and Continuous Delivery Strategy:** https://kip.quest/flightdeck/guides/testflight-build-expiration-90-days-strategy - A practical guide to managing Apple's strict 90-day TestFlight build expiration clock, monitoring build lifespans with FlightDeck MCP, and establishing a continuous beta delivery cadence. - **Can You Distribute iOS Apps Without an Apple Developer Account?:** https://kip.quest/flightdeck/guides/distribute-ios-apps-without-apple-developer-account - A clear architectural breakdown of free Apple ID sideloading limits, Ad Hoc provisioning, TestFlight requirements, and why FlightDeck requires an Apple Developer Program membership. - **iOS Developer Mode Explained: Do TestFlight Beta Testers Need It?:** https://kip.quest/flightdeck/guides/ios-developer-mode-testflight-testers - A definitive guide explaining what iOS Developer Mode does, when it is required in iOS 16/17/18, and why TestFlight beta testers never need to enable it.