appstore-api-mcp 1.1.1 → 1.1.3

package/CHANGELOG.md

@@ -4,6 +4,20 @@ 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.3] - 2026-06-02
+
+### Changed
+- Lead with analytics in the package/repo description, README one-liner, and
+  keywords — downloads, revenue, and subscriptions are now front and center.
+
+## [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/README.md

@@ -14,8 +14,9 @@
 **Run App Store Connect by talking to your AI.** An
 [MCP](https://modelcontextprotocol.io) server that turns Apple's
 [App Store Connect API](https://developer.apple.com/documentation/appstoreconnectapi)
-into plain-language actions — edit your listings, audit your whole portfolio,
-and reach the entire API, from whatever AI agent you already use.
+into plain-language actions — edit your listings, **track downloads, revenue &
+subscriptions**, audit your whole portfolio, and reach the entire API, from
+whatever AI agent you already use.
 
 ### ✨ What makes it stand out
 

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,7 +1,7 @@
 {
   "name": "appstore-api-mcp",
-  "version": "1.1.1",
-  "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.",
+  "version": "1.1.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": {
     "appstore-api-mcp": "src/index.js"
@@ -33,7 +33,11 @@
     "cursor",
     "keywords",
     "screenshots",
-    "metadata"
+    "metadata",
+    "analytics",
+    "app-analytics",
+    "subscriptions",
+    "aso-tools"
   ],
   "license": "MIT",
   "author": "Sviatoslav Fil",

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) {