aeo_visibility_report
ChatGPTThe aggregate standing across every tracked question's latest snapshot: how often an assistant recommends the app, its average and best position, share of voice across all recommendation slots handed out, the rival leaderboard (who the assistants recommend instead, which is often not who the store's search results imply), and the questions the app is invisible on. Read this before deciding what to change.
apple_apply_create_version
ChatGPTApplies a change the person approved on a MetaRun change card. Called by the card's Apply button only; it requires the card's approval ticket for exactly the previewed change.
apple_apply_import_fastlane_metadata
ChatGPTApplies a change the person approved on a MetaRun change card. Called by the card's Apply button only; it requires the card's approval ticket for exactly the previewed change.
apple_apply_respond_to_review
ChatGPTApplies a change the person approved on a MetaRun change card. Called by the card's Apply button only; it requires the card's approval ticket for exactly the previewed change.
apple_apply_revert_change
ChatGPTApplies a change the person approved on a MetaRun change card. Called by the card's Apply button only; it requires the card's approval ticket for exactly the previewed change.
apple_apply_set_app_info_localization
ChatGPTApplies a change the person approved on a MetaRun change card. Called by the card's Apply button only; it requires the card's approval ticket for exactly the previewed change.
apple_apply_set_promotional_text
ChatGPTApplies a change the person approved on a MetaRun change card. Called by the card's Apply button only; it requires the card's approval ticket for exactly the previewed change.
apple_apply_set_territory_prices
ChatGPTApplies a change the person approved on a MetaRun change card. Called by the card's Apply button only; it requires the card's approval ticket for exactly the previewed change.
apple_apply_set_version_build
ChatGPTApplies a change the person approved on a MetaRun change card. Called by the card's Apply button only; it requires the card's approval ticket for exactly the previewed change.
apple_apply_set_version_localization
ChatGPTApplies a change the person approved on a MetaRun change card. Called by the card's Apply button only; it requires the card's approval ticket for exactly the previewed change.
apple_apply_submit_for_review
ChatGPTApplies a change the person approved on a MetaRun change card. Called by the card's Apply button only; it requires the card's approval ticket for exactly the previewed change.
apple_get_app_pricing
ChatGPTGet an app's paid-app price schedule (base territory and per-territory prices).
apple_get_listing_coverage
ChatGPTWhich listing fields are actually FILLED, per language, on a version: a filled/empty map for every listing language plus gaps (field -> the languages still missing it) and submissionBlockers. This is how you VERIFY a multi-language mission instead of trusting the transcript: after writing copy across languages, call this and report what it says. Defaults to the editable version; pass versionId to target another. Cheap (two reads) and returns flags, not copy: use apple_list_version_localizations when you need the actual text.
apple_get_listing_editability
ChatGPTWhich listing surfaces are editable right now. Apple locks name/subtitle, categories, age rating, version listing text, and screenshots while a live app has no editable version; content rights and accessibility stay editable anytime. Promotional text is instant on a live app and, on an app that has never shipped, is saved on the version in preparation (the surface carries that note, and liveVersion tells the two apart). Returns per-surface flags with reasons + the editable and live versions if any, and hasShipped (whether the app was ever released; What's New only exists once it was). Check before proposing listing changes and relay the reason when locked.
apple_get_review_summary
ChatGPTGet Apple's AI-generated customer review summary (the one shown on the product page), optionally for a single territory. A fast answer to "what are users saying?".
apple_list_app_metadata
ChatGPTList the app's full per-locale store listing: app-level name and subtitle merged with the latest version's description, keywords, promotional text, and what's new. The prime surface for ASO and translation work.
apple_list_apps
ChatGPTList all apps in the connected App Store Connect account, with their bundle ids, names, and SKUs. Call this first to discover the bundleId for other tools. When the user's plan caps the number of apps, only the plan's ACTIVE apps are listed (the user picks them in Settings > Preferences; account_get_app_selection shows the full picture).
apple_list_builds
ChatGPTList an app's recent builds (newest first) with processing state and encryption flags. usesNonExemptEncryption unset = Missing Compliance; fix via apple_preview_declare_build_encryption.
apple_list_review_submissions
ChatGPTList every App Review submission for an app, newest first (an unsent draft leads), with the status App Store Connect shows (Ready for Review, Waiting for Review, In Review, Unresolved Issues, Review Completed, ...), the platform, the submitted date, who submitted it (a team member, an API key, where isConnectedKey marks the key connected to MetaRun, or Xcode Cloud), the version it carries, and each item's verdict (Approved, Rejected, ...). Returns 20 by default. Use it when a version shows Rejected or Metadata Rejected, or when the user asks about review status or why an app was rejected. Filter with states (e.g. ["UNRESOLVED_ISSUES"] for rejections waiting on the developer); open one with apple_get_review_submission. Apple exposes NO endpoint for App Review's messages (the rejection reason, cited guidelines, the review device, OS version and date, attachments) or for replying to them: each submission's appStoreConnectUrl is the exact App Store Connect page where they are read and answered, the only place a rejection's reason is available.
apple_list_reviews
ChatGPTList an app's App Store customer reviews (rating, title, body, territory, any published developer response). Filter by star rating or territory, or to unanswered reviews only; sort by recency or rating.
apple_list_supported_locales
ChatGPTList every language App Store Connect supports for an app listing, with its exact locale code. Pass a bundleId to also mark which are already configured on that app. To ADD a new language, pick an unconfigured code, then use apple_preview_set_app_info_localization (a name is required to create it) and/or apple_preview_set_version_localization for that locale; applying the change creates the locale.
apple_list_versions
ChatGPTList an app's App Store versions (newest first) with version string, state, release type, and phased-release progress. Returns the newest 20 by default; pass a higher limit only when the user asks about deep version history. A version in Rejected or Metadata Rejected: call apple_list_review_submissions for its submission, each item's verdict, and the link to App Review's message.
apple_preview_create_version
ChatGPTPreview creating a new App Store version. Apple allows only ONE editable version at a time: if a draft already exists, creation fails ('You cannot create a new version of the App in the current state'); renumber the existing draft with apple_preview_set_version_string instead. In ChatGPT this shows the person a MetaRun change card with the exact before and after. Nothing changes until THEY press Apply on the card; you cannot apply it yourself, so never ask them to type a confirmation. If the card says the store changed or the preview expired, call this tool again with the same input.
apple_preview_import_fastlane_metadata
ChatGPTUse this when the person wants listing copy written, translated, or rewritten across one or MORE languages at once (name, subtitle, description, keywords, What's New, promotional text, support and marketing URLs). YOU write the copy; pass it as metadata: { "de-DE": { "subtitle": "...", "keywords": "..." }, "ja": { ... } } using exact App Store locale codes (apple_list_supported_locales) and Apple's limits (name and subtitle 30 characters, keywords 100, promotional text 170, description 4000). Unchanged fields are skipped, over-limit fields and locked surfaces come back as warnings, and it never clears a field. Prefer this over one call per language: one card, one Apply. In ChatGPT this shows the person a MetaRun change card with the exact before and after. Nothing changes until THEY press Apply on the card; you cannot apply it yourself, so never ask them to type a confirmation. If the card says the store changed or the preview expired, call this tool again with the same input.
apple_preview_respond_to_review
ChatGPTPreview responding to a customer review (or replacing the existing response). The response becomes publicly visible on the App Store; needs an Admin or Customer Support role key. In ChatGPT this shows the person a MetaRun change card with the exact before and after. Nothing changes until THEY press Apply on the card; you cannot apply it yourself, so never ask them to type a confirmation. If the card says the store changed or the preview expired, call this tool again with the same input.
apple_preview_revert_change
ChatGPTUse this when the person wants to undo a change made through MetaRun. Pass the change id from history_search; the card shows what the field holds now and what it would go back to. In ChatGPT this shows the person a MetaRun change card with the exact before and after. Nothing changes until THEY press Apply on the card; you cannot apply it yourself, so never ask them to type a confirmation. If the card says the store changed or the preview expired, call this tool again with the same input.
apple_preview_set_app_info_localization
ChatGPTPreview editing the app-level listing for one locale: store name, subtitle, privacy policy URL, privacy choices URL. This is also THE tool for setting or changing a language's privacy policy URL (Apple requires one per listing language before review). Blocked while the listing info is not editable (live app with no editable version; check apple_get_listing_editability). Also the way to ADD a new listing language: pass an unconfigured locale code (see apple_list_supported_locales); creating a new locale requires a name, and when no privacyPolicyUrl is passed the preview carries it over from an existing language as a warned diff row (tell the user to verify that link serves the new language, or set a language-specific URL). In ChatGPT this shows the person a MetaRun change card with the exact before and after. Nothing changes until THEY press Apply on the card; you cannot apply it yourself, so never ask them to type a confirmation. If the card says the store changed or the preview expired, call this tool again with the same input.
apple_preview_set_promotional_text
ChatGPTPreview updating the promotional text for one locale. On an app with a live version this is the instant path: no new version, no App Review, live within moments. On an app that has never shipped there is nothing live, so the text is saved on the version in preparation and reaches the store when that version is released; the preview says which of the two it targeted. Max 170 characters. In ChatGPT this shows the person a MetaRun change card with the exact before and after. Nothing changes until THEY press Apply on the card; you cannot apply it yourself, so never ask them to type a confirmation. If the card says the store changed or the preview expired, call this tool again with the same input.
apple_preview_set_territory_prices
ChatGPTPreview a bulk app reprice: base-territory price + per-territory overrides (max 200), replacing the whole schedule. Compute targets with pricing_compute_prices; its stagedInput feeds this directly. Prices must match Apple price points; misses return the closest alternatives. Manual overrides not restated revert to automatic pricing (shown in the diff). In ChatGPT this shows the person a MetaRun change card with the exact before and after. Nothing changes until THEY press Apply on the card; you cannot apply it yourself, so never ask them to type a confirmation. If the card says the store changed or the preview expired, call this tool again with the same input.
apple_preview_set_version_build
ChatGPTPreview attaching a build to an App Store version (the 'Build' slot; required before submitting for review). Pick a processed build from apple_list_builds. Blocked when the version is not editable, the build expired, or it is already attached. In ChatGPT this shows the person a MetaRun change card with the exact before and after. Nothing changes until THEY press Apply on the card; you cannot apply it yourself, so never ask them to type a confirmation. If the card says the store changed or the preview expired, call this tool again with the same input.
apple_preview_set_version_localization
ChatGPTPreview editing a version's per-locale listing. Requires a version in an editable state (check apple_get_listing_editability). Also the way to ADD a new listing language: pass an unconfigured locale code (see apple_list_supported_locales) and applying creates it on the version. Submission requires Description, Keywords, and Support URL per language, plus What's New on updates; when adding or filling a language, set them all (translated into that language) or the submit preview will block on the gaps. whatsNew applies from the first update onward: Apple has no What's New on a first version (App Store Connect hides the field). In ChatGPT this shows the person a MetaRun change card with the exact before and after. Nothing changes until THEY press Apply on the card; you cannot apply it yourself, so never ask them to type a confirmation. If the card says the store changed or the preview expired, call this tool again with the same input.
apple_preview_submit_for_review
ChatGPTUse this when the person asks whether a version is ready to ship, why Submit is blocked, or to send a version (or a rejected one) to App Review. Runs MetaRun's readiness sweep: version state, attached build, export compliance, App Privacy, required listing fields in every language, and what App Review already holds. The card lists every blocker; when nothing blocks, it offers Submit, which the person must explicitly acknowledge. In ChatGPT this shows the person a MetaRun change card with the exact before and after. Nothing changes until THEY press Apply on the card; you cannot apply it yourself, so never ask them to type a confirmation. If the card says the store changed or the preview expired, call this tool again with the same input.
aso_check_rank
ChatGPTOne live App Store search: the app's current rank for a term on a storefront (top 200) plus the term's top 10 apps (who owns the keyword). Does not need the term to be tracked and does not store a snapshot; use aso_track_keywords + aso_scan_ranks for history. Rate limited by Apple (~20 searches/min): batch politely.
aso_lint_metadata
ChatGPTApp Store metadata linter: character budgets (name/subtitle 30, keywords 100), spaces after commas, empty entries, duplicates, keyword words already indexed by name/subtitle (wasted), trivial plural pairs. Returns findings, a cleaned keyword field (fixedKeywords) with reclaimed characters, and term coverage when trackedTerms is given. Fetch current values via apple_list_app_metadata + apple_list_version_localizations.
aso_list_rank_and_rival_alerts
ChatGPTUse this when the person asks what moved for their app lately. MetaRun's background scan records rank gains and drops of 5 or more places for tracked keywords, keywords falling out of the top 200 or entering the top 10, and changes to rival apps' listings. Returns alerts the person has not dismissed yet (includeAcknowledged for all), optionally for one app (bundleId). It only reports: to act on an alert, prepare a change the person can approve, for example new keywords with apple_preview_import_fastlane_metadata.
aso_suggest_keywords
ChatGPTApple's live search autocomplete for a seed term on one storefront: the exact suggestions the App Store shows users as they type, in Apple's order (a rough popularity signal). The core keyword-discovery primitive: expand seeds from the app's category, reviews, and competitor names, then rank-check the promising ones with aso_check_rank.
audit_storefront_languages
ChatGPTUse this when someone asks how an App Store listing looks in other countries, which storefronts show it in a language people there cannot read, or whether localized screenshots are missing, for ANY app (theirs or a competitor's) and without a MetaRun account. Reads Apple's public storefront data for 25 major markets. Pass an App Store link, numeric id or bundle id when you have one; a bare name that matches several apps comes back as a short list to choose from (nothing runs until the person picks, then call again with the chosen appStoreId).
calculate_worldwide_prices
ChatGPTUse this when someone asks what an app should cost in other countries, how to price fairly by purchasing power, or what a price converts to across the App Store's storefronts, for ANY app and without a MetaRun account. Takes one base price and a strategy (ppp = purchasing power parity, bigmac, spotify, or direct conversion) and returns a price for every storefront, snapped to Apple's real price points and compared with a straight currency conversion. To change the prices of the person's own app, use pricing_compute_prices after they connect MetaRun.
check_ai_visibility
ChatGPTUse this when someone asks whether AI assistants recommend their app (or any app), why a rival gets recommended instead, or which websites shape those answers. MetaRun asks a live search-grounded answer engine three questions a real person would ask about the app's category and scores whether the app is named and recommended, who is recommended instead, and which sources the answers cite. Works for any App Store app without a MetaRun account; results are cached for a day. Pass an App Store link, numeric id or bundle id when you have one (for the person's own apps, apple_list_apps gives the bundle id); a bare name that matches several apps comes back as a short list to choose from, and nothing is checked until the person picks. Pass niche (e.g. 'habit tracker') when the store category is broader than what the app really is.
history_search
ChatGPTUse this when the person asks what changed, when, or who changed it: every change applied through MetaRun (web app, its AI operator MILO, coding agents, or ChatGPT) is recorded with its before and after. Filter by app (bundleId), source, recency, or a field such as 'subtitle'. Each hit's id can be passed to apple_preview_revert_change to undo it.
metarun_get_profile
ChatGPTReturns the MetaRun profile this connection acts as: an opaque id that stays the same across reconnections, plus a display name, email, and a label naming the workspace. Use it when the person asks which MetaRun account or workspace is connected.
pricing_compute_prices
ChatGPTUse this when the person wants to reprice THEIR app (or an in-app purchase or subscription) across App Store storefronts with MetaRun's pricing engine: purchasing power parity (ppp), Big Mac index, Spotify index, or a straight conversion, snapped to Apple's real price points and compared with their current schedule. Returns per-storefront rows (current vs target) and a stagedInput: pass stagedInput unchanged to apple_preview_set_territory_prices (app), apple_preview_set_iap_price or apple_preview_set_subscription_price to show the change card. For an app the person does not own, or before they sign in, use calculate_worldwide_prices instead.
studio_list_projects
ChatGPTList the user's Screenshot Studio projects (marketing screenshot designs) with the app each designs for (bundleId), slide counts, languages, and output size. Projects are per-app: pick the one whose bundleId matches the app being discussed. Studio projects are drafts; they reach the App Store via the studio's publish flow, after which apple_list_screenshots shows them live.
studio_store_preview
ChatGPTShow how the studio slides will LOOK ON THE APP STORE: renders the first slides server-side and pairs them with the app's real listing chrome (current store name + subtitle from App Store Connect, live icon/rating/genre from the public storefront) as a search-results or product-page preview. The Command Deck projects the result as a store bay. mode search shows the 3-up strip users meet in search; product shows the product-page gallery (up to 6 slides). Uses the project's linked app unless bundleId overrides it.