appstore-api-mcp 1.1.1 → 1.1.2

package/CHANGELOG.md

@@ -4,6 +4,14 @@ 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.1.2] - 2026-06-02
+
+### Fixed
+- Report tools now treat a `404` ("no data for this report/date") as a clean
+  empty result with an explanatory `note`, instead of surfacing it as an error.
+  Validated end-to-end with an Admin key: sales, subscriptions, finance, and the
+  Analytics Reports API all return real data.
+
 ## [1.1.1] - 2026-06-02
 
 ### Changed

package/docs/ANALYTICS.md

@@ -30,7 +30,10 @@ Sales and finance reports are scoped to a **Vendor Number** — an 8–9 digit I
 **not** the same as your Key ID or Issuer ID.
 
 - Find it in **App Store Connect → Payments and Financial Reports** (or **Sales
-  and Trends**) — it's shown near your legal entity / at the top of the reports.
+  and Trends**) — it's the **Vendor #** shown at the top:
+
+![Where to find the Vendor Number in App Store Connect → Payments and Financial Reports](https://raw.githubusercontent.com/fil-technology/appstore-api-mcp/main/assets/where-to-find-vendor-number.png)
+
 - Provide it either way:
   - **Per call:** pass `vendorNumber` in the tool arguments, or
   - **Globally:** set the `ASC_VENDOR_NUMBER` environment variable in your MCP config.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "appstore-api-mcp",
-  "version": "1.1.1",
+  "version": "1.1.2",
   "description": "MCP server for Apple App Store Connect — manage apps, keywords, descriptions, titles, screenshots, versions and the full API from any MCP client (Claude, Codex, Cursor, Cline, Windsurf, VS Code, Zed, Continue, Gemini CLI, Google Antigravity, Amazon Q, Goose, and custom agents). Includes a fleet-wide ASO audit and dry-run previews.",
   "type": "module",
   "bin": {

package/src/client.js

@@ -157,6 +157,9 @@ export class AppStoreConnectClient {
       headers: { Authorization: `Bearer ${token}`, Accept: "application/a-gzip" },
     });
     const buf = Buffer.from(await res.arrayBuffer());
+    // 404 from a report endpoint means "no data for this report/date" — not a
+    // failure. Return empty so callers get an empty result, not an error.
+    if (res.status === 404) return "";
     if (!res.ok) {
       let detail = buf.toString("utf8");
       try {

package/src/index.js

@@ -134,7 +134,7 @@ const DEFAULT_VENDOR = process.env.ASC_VENDOR_NUMBER;
 /** Cap parsed report rows so large reports don't flood the response. */
 function reportResult(reportType, parsed, limit = 200) {
   const rows = parsed.rows;
-  return {
+  const out = {
     reportType,
     columns: parsed.columns,
     rowCount: rows.length,
@@ -142,6 +142,10 @@ function reportResult(reportType, parsed, limit = 200) {
     truncated: rows.length > limit,
     rows: rows.slice(0, limit),
   };
+  if (rows.length === 0)
+    out.note =
+      "No data found for the requested report/date. The period may have no activity, or the data isn't available yet (reports lag ~1 day). Check the date and frequency format.";
+  return out;
 }
 
 function requireVendor(v) {