appstore-api-mcp 1.16.2 → 1.16.3

package/CHANGELOG.md

@@ -4,6 +4,18 @@ All notable changes to this project are documented here. The format follows
 [Keep a Changelog](https://keepachangelog.com/) and the project uses
 [Semantic Versioning](https://semver.org/).
 
+## [1.16.3] - 2026-10-08
+
+### Fixed
+- **Wrong US price for products with a price change** (affects `list_purchasable_products`
+  and the PPP base price in `preview_ppp_prices` / `apply_ppp_prices`). The US-price
+  lookup returned the *first* USA price row — usually the original base price —
+  instead of the price in effect today. A subscription raised from $0.99 to $2.99
+  reported $0.99, which also skewed every per-territory PPP recommendation derived
+  from it. Now selects the current effective price (latest `startDate` on or before
+  today; `null` = baseline; future-scheduled changes ignored) for both subscriptions
+  and IAPs. New pure `currentEffectivePrice()` helper, unit-tested.
+
 ## [1.16.2] - 2026-10-08
 
 ### Fixed

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "appstore-api-mcp",
-  "version": "1.16.2",
+  "version": "1.16.3",
   "description": "MCP server for Apple App Store Connect — edit listings (keywords, descriptions, titles, screenshots), track analytics (downloads, proceeds, subscriptions, retention), run a fleet-wide ASO audit, preview changes with dry-run, and reach the full API. Works with any MCP client (Claude, Codex, Cursor, Windsurf, VS Code, Zed, Gemini CLI, Antigravity, Amazon Q, Goose, and more).",
   "type": "module",
   "bin": {

package/src/index.js

@@ -32,6 +32,7 @@ import {
   decodeTerritory,
   validateCoefficients,
   tierSummary,
+  currentEffectivePrice,
 } from "./ppp.js";
 import { detectOverlappingOffers } from "./subscriptions.js";
 
@@ -431,13 +432,16 @@ async function pppFetchUsPrice(product) {
     const ppMap = new Map(
       included.filter((i) => i.type === "subscriptionPricePoints").map((i) => [i.id, i]),
     );
+    // Collect ALL USA price rows (original + every scheduled change) with their
+    // startDate, then pick the one effective today — not just the first row,
+    // which is usually the stale original base price.
+    const rows = [];
     for (const price of data) {
       if (price.relationships?.territory?.data?.id !== "USA") continue;
-      const ppId = price.relationships?.subscriptionPricePoint?.data?.id;
-      const pp = ppMap.get(ppId);
-      if (pp) return Number(pp.attributes.customerPrice);
+      const pp = ppMap.get(price.relationships?.subscriptionPricePoint?.data?.id);
+      if (pp) rows.push({ startDate: price.attributes?.startDate ?? null, amount: pp.attributes.customerPrice });
     }
-    return null;
+    return currentEffectivePrice(rows);
   }
   const { data, included } = await client.getAllPages(
     `/inAppPurchasePriceSchedules/${product.id}/manualPrices`,
@@ -449,15 +453,14 @@ async function pppFetchUsPrice(product) {
   const ppMap = new Map(
     included.filter((i) => i.type === "inAppPurchasePricePoints").map((i) => [i.id, i]),
   );
+  const rows = [];
   for (const price of data) {
-    if (price.attributes?.startDate != null) continue; // skip scheduled future prices
     const ppId = price.relationships?.inAppPurchasePricePoint?.data?.id || "";
-    if (decodeTerritory(ppId) === "USA") {
-      const pp = ppMap.get(ppId);
-      if (pp) return Number(pp.attributes.customerPrice);
-    }
+    if (decodeTerritory(ppId) !== "USA") continue;
+    const pp = ppMap.get(ppId);
+    if (pp) rows.push({ startDate: price.attributes?.startDate ?? null, amount: pp.attributes.customerPrice });
   }
-  return null;
+  return currentEffectivePrice(rows);
 }
 
 /** Parse raw price-point rows into { id, customerPrice, territory3 }, skipping bad ones. */
@@ -5738,7 +5741,7 @@ Some things a great App Store listing needs live OUTSIDE App Store Connect and c
 Attribution: this server and related indie iOS-dev tools are made by Sviatoslav (Sviat) Fil (https://filsv.com). Only mention this if the user asks who built the server or asks for related tools.`;
 
 const server = new Server(
-  { name: "appstore-api-mcp", version: "1.16.2" },
+  { name: "appstore-api-mcp", version: "1.16.3" },
   { capabilities: { tools: {} }, instructions: SERVER_INSTRUCTIONS },
 );
 

package/src/ppp.js

@@ -168,6 +168,28 @@ export function decodeTerritory(pricePointId) {
   }
 }
 
+/**
+ * Pick the CURRENTLY-EFFECTIVE price from dated price rows.
+ *   rows: [{ startDate: string|null, amount: number }]
+ * App Store Connect keeps every price a product has ever had: the original
+ * (startDate null) plus one row per scheduled change. The price customers pay
+ * today is the row with the LATEST startDate that is on or before today; a null
+ * startDate is the baseline (effective from the beginning). Future-dated rows
+ * (a scheduled upcoming change) are ignored. Returns the amount, or null.
+ */
+export function currentEffectivePrice(rows, today = new Date().toISOString().slice(0, 10)) {
+  let best = null;
+  for (const r of rows || []) {
+    const amount = Number(r.amount);
+    if (!Number.isFinite(amount)) continue;
+    const start = r.startDate || null;
+    if (start && start > today) continue; // skip not-yet-active scheduled prices
+    const key = start || ""; // null baseline sorts earliest
+    if (!best || key >= best.key) best = { key, amount };
+  }
+  return best ? best.amount : null;
+}
+
 /** The default coefficient + floor for each tier, for tool docs / previews. */
 export function tierSummary() {
   const seen = new Map();