mcpField
A
asc-id-resolver

asc-id-resolver

github.com/rorkaiDevelopment1.1k7.6k installsUpdated 2d ago
Repository

About asc-id-resolver

asc-id-resolver is a skill that guides developers in using the asc CLI to resolve App Store Connect resource identifiers needed by other commands. It covers apps, builds, versions, digital goods, and TestFlight, with guidance for listing and output formats.

Key features

  1. 01Find app and build IDs
  2. 02Resolve version and digital-goods IDs
  3. 03Find TestFlight and review IDs
  4. 04Recommend pagination and deterministic sorting
  5. 05Guide terminal and automation output

Use cases

  1. 01Look up an app ID by name
  2. 02Locate a build for a version or upload
  3. 03Resolve subscription and IAP version IDs
  4. 04Find a TestFlight group ID

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/rorkai/app-store-connect-cli-skills --skill asc-id-resolver

After installing, type/asc-id-resolverin Claude Code to confirm it loaded.

Details

From the project README

asc id resolver

Use this skill to map names to IDs needed by other commands.

App ID

  • By bundle ID or name:
    • asc apps list --bundle-id "com.example.app"
    • asc apps list --name "My App"
  • Fetch everything:
    • asc apps list --paginate
  • Set default:
    • ASC_APP_ID=...

Build ID

  • Latest build:
    • asc builds info --app "APP_ID" --latest --version "1.2.3" --platform IOS
  • Recent builds:
    • asc builds list --app "APP_ID" --sort -uploadedDate --limit 5
  • Skip the lookup when attaching or submitting: asc versions attach-build and asc review submit accept --app, --version, and --build-number "45".

Version ID

  • asc versions list --app "APP_ID" --paginate

Digital-goods version IDs

API 4.4.1 version IDs are distinct from IAP product, subscription, and subscription-group IDs:

Resolve the owning resources first:

  • IAPs: asc iap list --app "APP_ID" --paginate --output json
  • Subscription groups: asc subscriptions groups list --app "APP_ID" --paginate --output json
  • Subscriptions: asc subscriptions list --app "APP_ID" --paginate --output json or asc subscriptions list --group-id "GROUP_ID" --paginate --output json

Then resolve their version IDs:

  • IAP versions: asc iap versions list --iap-id "IAP_ID" --paginate --output json
  • Subscription versions: asc subscriptions versions list --subscription-id "SUB_ID" --paginate --output json
  • Subscription group versions: asc subscriptions groups versions list --group-id "GROUP_ID" --paginate --output json

Resolve child localization or image IDs from the corresponding version subtree:

  • IAP localizations: asc iap versions localizations list --version-id "VERSION_ID" --paginate --output json
  • IAP primary image: asc iap versions image --version-id "VERSION_ID" --output json
  • IAP image collection: asc iap versions images list --version-id "VERSION_ID" --paginate --output json
  • Subscription localizations: asc subscriptions versions localizations list --version-id "VERSION_ID" --paginate --output json
  • Subscription primary image: asc subscriptions versions images primary --version-id "VERSION_ID" --output json
  • Subscription image collection: asc subscriptions versions images list --version-id "VERSION_ID" --paginate --output json
  • Subscription-group localizations: asc subscriptions groups versions localizations list --version-id "VERSION_ID" --paginate --output json

TestFlight IDs

  • Groups:
    • asc testflight groups list --app "APP_ID" --paginate
  • Testers:
    • asc testflight testers list --app "APP_ID" --paginate

Pre-release version IDs

  • asc testflight pre-release list --app "APP_ID" --platform IOS --paginate

Review submission IDs

  • asc review submissions list --app "APP_ID" --paginate

Output tips

  • Output defaults are TTY-aware: table in a terminal and minified JSON in pipes or CI. An explicit --output wins.
  • Use explicit --output json for automation and add --pretty only for human-readable JSON.
  • For human viewing, use --output table or --output markdown.

Guardrails

  • Prefer --paginate on list commands to avoid missing IDs.
  • Use --sort where available to make results deterministic.

Comments

Markdown supported