Skip to content

zelentsov-dev/asc-mcp

v3.0.0 Breaking

This release includes 2 breaking changes for platform teams planning a safe upgrade.

Published 5d MCP SaaS Integrations
✓ No known CVEs patched
Read the diff → Tool health → What is this tool? →

✓ No known CVEs patched in this version

Topics

ai-tools app-store-connect claude ios mcp model-context-protocol
+2 more
swift testflight

Affected surfaces

breaking_upgrade auth

ReleasePort's take

Moderate signal
editorial:auto 5d

Version 3.0.0 removes the public prefixes `offer_codes_*`, `intro_offers_*`, `promo_offers_*`, and `winback_*` from the v3 worker schema.

Why it matters: The removal breaks any client code that references these prefixes; update integrations before upgrading to version 3.0.0.

Summary

AI summary

Updates Subscription Changes, Summary, and In-App Purchase Changes across a mixed release.

Changes in this release

Breaking High

Removed public prefixes `offer_codes_*`, `intro_offers_*`, `promo_offers_*`, and `winback_*` from v3 worker schema.

Removed public prefixes `offer_codes_*`, `intro_offers_*`, `promo_offers_*`, and `winback_*` from v3 worker schema.

Source: llm_adapter@2026-05-29

Confidence: high

 —
Feature Medium

Added `subscriptions_list_prices` support for `territory_id`, price-point includes, and normalized price output.

Added `subscriptions_list_prices` support for `territory_id`, price-point includes, and normalized price output.

Source: llm_adapter@2026-05-29

Confidence: high

 —
Feature Medium

Added `subscriptions_list_price_points` with territory filtering and limit up to 8000.

Added `subscriptions_list_price_points` with territory filtering and limit up to 8000.

Source: llm_adapter@2026-05-29

Confidence: high

 —
Feature Medium

Added normalized territory‑aware price reads for offer‑code, promotional‑offer, and win‑back offer prices.

Added normalized territory‑aware price reads for offer‑code, promotional‑offer, and win‑back offer prices.

Source: llm_adapter@2026-05-29

Confidence: high

 —
Feature Medium

Added IAP inventory, pricing summary, price‑point equalizations, availability reads, promoted purchase, offer‑code CRUD, one‑time‑code, and custom‑code tools.

Added IAP inventory, pricing summary, price‑point equalizations, availability reads, promoted purchase, offer‑code CRUD, one‑time‑code, and custom‑code tools.

Source: llm_adapter@2026-05-29

Confidence: high

 —
Feature Medium

Added `iap_list_price_points` support for `territory_id`, territory/currency includes, and limit up to 8000.

Added `iap_list_price_points` support for `territory_id`, territory/currency includes, and limit up to 8000.

Source: llm_adapter@2026-05-29

Confidence: high

 —
Feature Medium

`iap` offer code creation now validates matching `territory_ids` and `price_point_ids` before network calls.

`iap` offer code creation now validates matching `territory_ids` and `price_point_ids` before network calls.

Source: llm_adapter@2026-05-29

Confidence: high

 —
Feature Low

Version bumped to `3.0.0`; README and tool counts updated for 389 public tools across 32 worker domains.

Version bumped to `3.0.0`; README and tool counts updated for 389 public tools across 32 worker domains.

Source: llm_adapter@2026-05-29

Confidence: high

 —
Feature Low

`--read-only` flag now blocks new create/update/delete/submit/deactivate/generate/upload/set mutation tools before handler execution.

`--read-only` flag now blocks new create/update/delete/submit/deactivate/generate/upload/set mutation tools before handler execution.

Source: llm_adapter@2026-05-29

Confidence: high

 —
Full changelog

Summary

  • Major v3 commerce redesign for App Store Connect product management: subscriptions and one-time in-app purchases now expose AI-friendly discovery, pricing, availability, offer, asset, and promoted-purchase tools.
  • Subscription offer surfaces are consolidated under subscriptions_*; the old public prefixes offer_codes_*, intro_offers_*, promo_offers_*, and winback_* are no longer registered in the public v3 worker schema.
  • Version bumped to 3.0.0 and README/tool counts updated for 389 public tools across 32 worker domains.

Subscription Changes

  • Added direct and convenience subscription tools for groups, localizations, prices, price points, equalizations, availability, promoted purchase, inventory, pricing summary, and offer-price preparation.
  • subscriptions_list_prices now supports territory_id, price_point_id, territory/currency includes, and normalized price output.
  • subscriptions_list_price_points supports territory filtering and limit up to 8000.
  • Added normalized territory-aware price reads for offer-code, promotional-offer, and win-back offer prices.

In-App Purchase Changes

  • Added IAP inventory, pricing summary, price point equalizations, availability-by-IAP reads, available territories, promoted purchase, offer-code CRUD, one-time-code, and custom-code tools.
  • iap_list_price_points now supports territory_id, territory/currency includes, and limit up to 8000.
  • IAP offer code creation validates matching territory_ids and price_point_ids before any network call.

Safety and Compatibility

  • --read-only now blocks the new create/update/delete/submit/deactivate/generate/upload/set mutation tools before handler execution.
  • Live write validation was intentionally not performed; write behavior is covered by mock/unit request-construction tests.
  • Target Apple OpenAPI: App Store Connect API 4.3.1, SHA a14ab9cc8271c8a93d02599d6e7638bce400e9a0c1214ae0ecdcd05f1c21ca84.

Verification

  • swift test passed: 534 tests in 48 suites.
  • swift build -c release passed.
  • swift run asc-mcp openapi-coverage --spec /tmp/asc-commerce-v3/openapi.oas.json --output /tmp/asc-commerce-v3/coverage.md passed: 923 paths, 1208 operations, unclassified paths 0.

Breaking Changes

  • Removed public prefixes `offer_codes_*`, `intro_offers_*`, `promo_offers_*`, and `winback_*` from the v3 worker schema.
  • Version bumped to `3.0.0`.
View diff on GitHub

Weekly OSS security release digest.

The CVE patches and breaking changes that affected production tools this week. One email, every Sunday.

No spam, unsubscribe anytime.

Share this release

Share on X Share on Bluesky

Track zelentsov-dev/asc-mcp

Get notified when new releases ship.

Sign up free

About zelentsov-dev/asc-mcp

App Store Connect API server with 208 tools for managing apps, builds, TestFlight, subscriptions, reviews, and more — directly from any MCP client.

All releases →

Related context

Beta — feedback welcome: [email protected]