Docs

The App Deck MCP server

A hosted Model Context Protocol server that lets your AI assistant work on your App Store and Google Play listings — with your approval before anything goes live.

Server URL

Add this URL to any MCP client that supports remote servers. On first use the client opens App Deck in your browser; sign in, pick the organization, and approve. Requires an App Deck plan.

Copy
https://app-deck-one.vercel.app/api/mcp

Set up your client

Claude

Settings → Connectors → Add custom connector, paste the URL, then Connect.

Claude Code

Copy
claude mcp add --transport http --scope user app-deck https://app-deck-one.vercel.app/api/mcp

Cursor

Add to ~/.cursor/mcp.json, then click Login next to the server.

Copy
{
  "mcpServers": {
    "app-deck": {
      "url": "https://app-deck-one.vercel.app/api/mcp"
    }
  }
}

Codex

Copy
codex mcp add app-deck --url https://app-deck-one.vercel.app/api/mcp
codex mcp login app-deck

Things to ask

  • Using App Deck, list my apps and tell me which App Store languages are missing compared with the top 10 markets.
  • Translate the App Store listing of <app> into German, French and Japanese as App Deck drafts. Keep keywords under 100 characters.
  • Compare last month's downloads and conversion with the month before for all my apps and explain the biggest change.
  • Draft localized subscription names and descriptions for <app> in Spanish and Portuguese, then show me the preview before publishing.

Safety model

  • The agent acts as you, in your current organization, with your role.
  • It can only reach apps that are in your organization's workspace.
  • Writes start as drafts. Publishing returns a preview; the agent must show it to you and wait for your explicit approval. Previews expire after 30 minutes and can be used once.
  • Admins choose whether agents may publish text, and whether broader store writes are allowed at all.
  • You can revoke a client any time under Account → Connected MCP clients.

Tools

Workspace

Which organization the connection acts on, your role, the plan, and the apps in the workspace. App-scoped tools only work on apps added here.

  • workspace_get — Organization, role, plan, connections and workspace apps.
  • projects_add — Add an App Store or Google Play app to the workspace (uses a plan slot).

Google Play and app associations

Reads native Google Play listings, prepares local Android drafts and links store apps in App Deck. Store publication requires the separate approved text flow.

  • play_list_apps — Discover Google Play apps.
  • play_get_app — Verify access and read Android app/listings.
  • play_get_tracks — Read exact releases, version codes, notes, rollout and review lifecycle states.
  • play_get_localizations — Live native listing fields and supported Play locales.
  • play_get_brief — Verified Android source copy and localization prompts.
  • play_validate_localization — Validate Play title and descriptions.
  • play_save_localization_draft — Save listing text locally without publishing.
  • play_get_subscriptions — Subscriptions: per-language name, benefits, description, base plans and trial offers.
  • play_get_subscription_prices — Base-plan price per region against Google's tax-inclusive conversion.
  • play_validate_subscription_text — Validate subscription name, benefits and description.
  • apps_get_store_link — Read the Apple/Android app association.
  • apps_link_stores — Associate verified apps in App Deck when requested.

Read

Reads App Store Connect. Changes nothing.

  • asc_list_connections — Configured Apple and Google store connections with platform.
  • asc_list_apps — Every app reachable through a connection.
  • asc_get_app — App details, versions, and a completeness summary.
  • asc_get_versions — Versions and whether Apple accepts edits for them.
  • asc_get_localizations — One merged row per language, plus local drafts.
  • asc_get_subscriptions — Groups, products, draft versions, localizations.
  • asc_get_subscription_groups — Fresh group metadata versions, display names and custom app names.
  • asc_get_screenshots — Screenshot counts per device size for a language.
  • asc_get_retention_messages — Retention messages, versions, localized header/body and subscription assignments.
  • asc_get_retention_offers — Retention offers per subscription and the ones its message presents.
  • asc_get_subscription_prices — Current price per territory and available price points for offers.
  • asc_get_retention_images — Asset library images and Apple's retention image specs.

Drafts

Produces local drafts only. Nothing reaches Apple, and none of these need an AI provider — the connected agent writes the copy.

  • app_get_context — Per-app notes the agent uses as factual ground truth.
  • app_update_context — Updates those notes.
  • localization_get_brief — Source copy, context, and Apple's limits, so the agent writes the listing itself.
  • localization_save_draft — Stores copy the agent wrote. Dashboard updates; nothing is published.
  • localization_discard_draft — Deletes a saved draft for one locale. Apple is never touched.
  • subscriptions_save_localization_draft — Stores subscription copy the agent wrote. Dashboard updates; nothing is published.
  • localization_validate_draft — Runs Apple's field rules deterministically.
  • localization_compare_with_apple — Field-by-field diff against the live listing.
  • screenshots_coverage — Which languages are missing which device sizes.

Analytics

Computed facts, not narrative. The agent does the reasoning.

  • analytics_sync — Downloads Apple's latest daily reports.
  • analytics_get_summary — Totals and rates for a window.
  • analytics_get_timeseries — One point per day.
  • analytics_get_by_territory — Breakdown per App Store territory.
  • analytics_get_by_source — Breakdown per acquisition source.
  • analytics_compare_periods — This window against the one before it.
  • analytics_analyze_app — Every deterministic fact about one app.
  • analytics_analyze_portfolio — The same window across every app.

Apple Ads

Active Search Ads campaigns and spend. Read-only. Needs Apple Ads API credentials, or fixture mode.

  • ads_get_app_campaigns — Active campaigns for one app, with spend, taps, and installs for the window.
  • ads_get_portfolio — The same window across every app that has an active campaign.

Publish store text and release notes

Enabled by default, independently of broad writes. Preview changes in one or two languages, obtain explicit user approval, then publish only the approved text fields.

  • asc_prepare_text_publish — Shows exact before/after text changes and the full affected locale scope. Writes nothing.
  • asc_confirm_text_publish — Publishes approved text with a single-use preview id and verifies Apple’s values.
  • subscriptions_prepare_text_publish — Preview subscription copy and explicit metadata draft/localization creations. Writes nothing.
  • subscriptions_confirm_text_publish — Write approved subscription text and verify ASC metadata drafts. Does not submit App Review.
  • subscription_groups_prepare_text_publish — Preview group names and explicit metadata draft/localization creations.
  • subscription_groups_confirm_text_publish — Write approved group names and verify ASC metadata drafts. Does not submit App Review.
  • play_prepare_text_publish — Preview native Play text and missing-locale creations for explicit approval.
  • play_confirm_text_publish — Commit only approved listing text, reject stale previews and verify Google’s values.
  • play_prepare_release_notes_publish — Preview notes for an exact existing Play release, with explicit review-restart warnings.
  • play_confirm_release_notes_publish — Write approved release notes only, preserving binaries, rollout and other languages.
  • play_prepare_subscription_text_publish — Preview Play subscription text and missing-language creations for explicit approval.
  • play_confirm_subscription_text_publish — Write only approved Play subscription text, reject stale previews and verify Google’s values.

Retention messages

Enabled with text publishing. Preview retention message text (header ≤66, body ≤144, no prices or offers), new versions and subscription assignments, obtain explicit approval, then write only what was previewed.

  • retention_messages_prepare_publish — Preview messages, versions, locales and subscription assignments. Blocks price/offer wording. Writes nothing.
  • retention_messages_confirm_publish — Write the approved retention message plan and verify it. Does not submit App Review.

Retention offers and review

Registered only when MCP_ALLOW_APPLE_WRITES is true. Creates retention offers (price points resolved per territory or supplied), attaches them to messages, uploads message images, deletes retention resources and adds message versions for App Review.

  • retention_offers_prepare_publish — Preview new retention offers and message-offer changes. Writes nothing.
  • retention_offers_confirm_publish — Create the approved offers and attach/detach them, then verify.
  • retention_messages_prepare_review_submission — Preview adding message versions to a review submission, optionally submitting it.
  • retention_messages_confirm_review_submission — Add approved versions for review; submits only if previewed.
  • retention_images_prepare_upload — Check an image against Apple's specs and preview upload + placement.
  • retention_images_confirm_upload — Upload the approved image and create its retention placement.
  • retention_prepare_delete — Preview deleting messages, offers or unplaced images.
  • retention_confirm_delete — Permanently delete the approved retention resources.

Write and publish

Registered only when MCP_ALLOW_APPLE_WRITES is true. Prefer drafts and the web UI; do not use these unless the user explicitly asks to publish to Apple.

  • asc_prepare_publish — Validates, diffs, and returns a short-lived confirmation id.
  • asc_confirm_publish — Writes the prepared change. Needs the id, usable once.
  • asc_delete_screenshot — Removes one screenshot from Apple.
  • asc_reorder_screenshots — Replaces a screenshot set's order.

Ready? Create an account — you can explore with sample apps first.