Skip to content
OpenAgentSkill
Browsing is open · Catalog captured 2026-11-21 · Automatic updates and account services are paused.
Security

appstore-revenuecat-sync

App Store Connect and RevenueCat subscription/IAP reconciliation with `asc` and RevenueCat MCP for catalog bootstrap, drift audits, deterministic product/entitlement/offering/package mapping, and no deletions.

Xopoko · Static checks on file

Installation

Read the source and dependencies before running a command. Copying does not install or execute anything.

npx skills add Xopoko/build-swift-apps --skill appstore-revenuecat-sync

About this skill


name: appstore-revenuecat-sync description: App Store Connect and RevenueCat subscription/IAP reconciliation with asc and RevenueCat MCP for catalog bootstrap, drift audits, deterministic product/entitlement/offering/package mapping, and no deletions.

App Store RevenueCat Sync

Start read-only, build a diff, then create/update only after explicit confirmation. Never delete resources in this workflow.

Preconditions

  • asc auth configured.
  • RevenueCat MCP configured/authenticated; write-enabled API v2 key for apply.
  • Known APP_ID, RevenueCat project_id, target app type (app_store or mac_app_store), and bundle ID for create flows.

Canonical key: ASC productId == RevenueCat store_identifier. Never use display names as unique IDs.

Modes

  • Audit: read ASC + RevenueCat, find missing resources and conflicts, present plan.
  • Apply: after approval, ensure ASC items, RevenueCat app/products, entitlements/attachments, offerings/packages, then verify.

Read Sources

asc subscriptions groups list --app "APP_ID" --paginate --output json
asc iap list --app "APP_ID" --paginate --output json
asc subscriptions list --group-id "GROUP_ID" --paginate --output json

RevenueCat MCP tools: mcp_RC_get_project, mcp_RC_list_apps, mcp_RC_list_products, mcp_RC_list_entitlements, mcp_RC_list_offerings, mcp_RC_list_packages with pagination.

Type mapping:

  • subscription -> subscription
  • CONSUMABLE -> consumable
  • NON_CONSUMABLE -> non_consumable
  • NON_RENEWING_SUBSCRIPTION -> non_renewing_subscription

Entitlement defaults: one per subscription group, one per non-consumable, none for consumables unless requested.

Apply Order

  1. Create missing ASC resources, then re-read ASC to get canonical IDs:
    asc subscriptions groups create --app "APP_ID" --reference-name "Premium"
    asc subscriptions create --group-id "GROUP_ID" --reference-name "Monthly" --product-id "com.example.premium.monthly" --subscription-period ONE_MONTH
    asc iap create --app "APP_ID" --type NON_CONSUMABLE --ref-name "Lifetime" --product-id "com.example.lifetime"
    
  2. Ensure RevenueCat app/products with mcp_RC_create_app and mcp_RC_create_product; set store_identifier to ASC productId.
  3. Ensure entitlements and product attachments with mcp_RC_create_entitlement, mcp_RC_attach_products_to_entitlement, and verify with mcp_RC_get_products_from_entitlement.
  4. Optional offerings/packages: mcp_RC_create_offering, mcp_RC_update_offering, mcp_RC_create_package, mcp_RC_attach_products_to_package using eligibility_criteria: "all".

Recommended package keys: weekly $rc_weekly, monthly $rc_monthly, two-month $rc_two_month, three-month $rc_three_month, six-month $rc_six_month, annual $rc_annual, lifetime $rc_lifetime, custom $rc_custom_<name>.

Agent Rules

  • Always audit first, even when the user asks to apply.
  • Ask before create/update operations.
  • Match by store_identifier first.
  • Use full pagination (--paginate, starting_after).
  • Continue after per-item failures and report all together.
  • RevenueCat MCP does not create ASC products; use asc for ASC resources first.
  • Watch for wrong RevenueCat project/app, wrong platform app, consumables attached to entitlements, skipped ASC re-read, and unverified package/offering attachments.

Output

Summarize ASC created/skipped/failed counts, RevenueCat created/skipped/failed counts, attachment counts, and actionable failures.

References: examples.md, references.md.