Skip to main content
Pricing, subscriptions, and availability Level: Developer 9 min read

Configuring App Store Price Schedules and Free Tiers via MCP

How to inspect base price schedules, configure paid tiers, or transition your iOS app to Free using FlightDeck MCP with AI-assisted safety controls.

Published: 2026-10-31 • Last Updated: 2026-11-01 • Author: Kip Lawrence
Key MCP Tools: apps_listapp_price_schedule_getapp_price_schedule_set

Overview: Managing App Store Pricing via Chat

Managing your application's price on the Apple App Store is an impactful business decision. Whether launching as a free download, adjusting an upfront price point, or transitioning a paid app to Free to introduce a freemium model, you need to manage pricing safely without getting lost in App Store Connect web menus.

With FlightDeck connected to your AI coding assistant (Cursor, Claude Code, Xcode with MCP, or Antigravity), you can inspect current price points, evaluate business consequences, stage price adjustments, and verify global storefront propagation through natural-language conversation.

Because pricing modifications immediately impact public availability and revenue across 175 global storefronts, FlightDeck enforces a strict safety boundary: your assistant analyzes and stages the proposal, but no price change is transmitted to Apple until you authorize it in the FlightDeck Desktop Approval Center on your Mac.

Important

Key Distinctions in App Store Pricing:

  • Base App Price vs. In-App Purchases: The base price schedule governs only the upfront fee required to download the app from the App Store. It does not affect In-App Purchases (consumables, non-consumables) or auto-renewable subscriptions, which are managed independently.
  • Immediate vs. Scheduled Pricing: FlightDeck's app_price_schedule_set tool applies an immediate price schedule update anchored to a base territory (typically USA). FlightDeck does not schedule future calendar-based promotional windows. Once approved, the change takes effect directly on Apple's servers and propagates across global storefronts within 1 to 2 hours.
  • Zero Review Delay: Unlike binary updates or metadata changes, base price updates do not require Apple App Review.

The Primary Prompt: Inspect and Manage Pricing

Connect your AI coding assistant to FlightDeck and paste the following prompt:

TEXT
Please inspect the current App Store pricing for [Your App Name] using FlightDeck:

1. Identify my app and fetch our active price schedule and base territory.
2. Report our current customer price, currency, and whether the app is currently Free.
3. If I ask to change the price:
   - Explain the commercial consequences of the transition (especially for existing users or making a paid app free).
   - List available price points or confirm the Free tier.
   - Stage the proposal for my review in the FlightDeck Desktop Approval Center.
4. Do NOT execute any price change without my explicit confirmation.

What Happens Behind the Prompt

When you run this prompt, your assistant guides you through a safe, transparent pricing workflow:

TEXT
Developer Prompt: "Inspect pricing and change [App] to Free"
                                │
                                ▼
       [1. Dynamic App Discovery & Price Inspection]
       Assistant calls apps_list & app_price_schedule_get
       Retrieves current tier, currency, and available price points
                                │
                                ▼
       [2. Consequence Explanation in Chat]
       Assistant warns about irreversible licensing impacts
       and explains international storefront equalization
                                │
                                ▼
       [3. FlightDeck Desktop Approval Center]
       Developer reviews proposed transition (e.g., $0.99 -> Free)
                                │
                                ▼
       [4. Dispatch & Verification Readback]
       FlightDeck applies update; assistant confirms live Apple state

Stage 1: Inspect Current Pricing

Your assistant calls app_price_schedule_get to retrieve your active price schedule. FlightDeck queries Apple's appPriceSchedules resource and returns:

  • Base territory (e.g., USA)
  • Current retail price (e.g., $0.99 USD)
  • Estimated developer proceeds (e.g., $0.70 USD)
  • Free status flag (isFree: true or false)
  • Available standard Apple price tiers

Stage 2: Understand the Commercial Consequences

Before staging any mutation, your assistant explains the business impacts:

  1. Permanent Free Licenses: If you transition a paid app to Free, any user who downloads the app while it is free permanently acquires an App Store license. If you later raise the price back to paid, those users retain lifetime update rights without paying.
  2. Existing Paid Customers: Transitioning to Free does not issue refunds to past buyers, but their original purchase receipt remains valid in iOS.
  3. Global Equalization: Setting a price in the base territory (USA) causes Apple to automatically calculate equivalent local pricing and tax adjustments across all 175 storefronts worldwide.

Stage 3: Requesting a Price Transition

Transitioning to Free (isFree: true):

TEXT
Prompt: "Please stage a price update to make [Your App Name] Free."

FlightDeck dynamically discovers Apple's $0.00 price point for your application and stages the proposal.

Setting a Specific Paid Tier:

TEXT
Prompt: "Please stage a price update to set [Your App Name] to $2.99 USD."

Your assistant identifies the matching Apple price point (Tier 2) and stages the update anchored to the US storefront.


Desktop Approval Center Authorization

Because pricing changes alter commercial terms, FlightDeck halts execution and displays a staged card in the native Approval Center on your Mac.

Illustrative representation of the FlightDeck Approval Center sheet:

TEXT
┌────────────────────────────────────────────────────────────────────────┐
│  FlightDeck Approval Center: App Price Schedule Change                │
├────────────────────────────────────────────────────────────────────────┤
│  App: FocusFlow (ID: 6812899314)                                       │
│  Base Territory: United States (USA)                                   │
│  Current Price: $0.99 USD (Tier 1)                                     │
│  Proposed Price: Free ($0.00 USD)                                      │
│                                                                        │
│  Why: Transition base app to Free download for freemium model.          │
│                                                                        │
│  [!] Notice: Users who download while Free acquire a lifetime license. │
│      Apple propagates price updates globally within 1-2 hours.         │
├────────────────────────────────────────────────────────────────────────┤
│                       [ Reject ]      [ Approve ]                      │
└────────────────────────────────────────────────────────────────────────┘

You verify the change, then click Approve to execute.


Verifying the Updated Price Schedule

Once approved in FlightDeck, confirm that Apple's servers registered the new pricing:

TEXT
Please check App Store pricing for [Your App Name] again and confirm that our current customer price is now Free.

Your assistant queries app_price_schedule_get and reads back the updated remote state, confirming that Apple reflects the new retail price.


Frequently Asked Questions

Does changing the app price affect my existing subscribers or in-app purchases?

No. The base app price schedule controls only the upfront purchase price to download the application from the App Store. In-App Purchases (inAppPurchasesV2) and Auto-Renewable Subscriptions (subscriptions) maintain independent price tiers and are not modified by base price schedule updates.

Does a price change require submitting a new binary build?

No. Price schedule changes are purely commercial metadata updates on Apple's servers. You do not need to create a new version draft, upload a new build, or go through Apple App Review.

How quickly do price changes take effect on the App Store?

Once approved and dispatched via FlightDeck, price updates take effect immediately in App Store Connect and typically propagate across all international App Store storefronts within 1 to 2 hours.


Connect Your AI Agent to App Store Connect

FlightDeck runs locally on your Mac, keeping private keys secure in your macOS Keychain and executing mutations only after your explicit approval.

Download FlightDeck on Mac App Store