@pofky/asc-mcp 1.1.0 → 1.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,14 +1,17 @@
1
1
  # App Store Connect MCP Server
2
2
 
3
- > **Not another API wrapper.** This MCP server catches rejections before you submit, gives you a morning briefing across all your apps, and writes your release notes from git history. The 5 free tools cover basics. The 3 Pro tools are things no other ASC server does.
3
+ > **The App Store Connect intelligence layer for your coding agent.** 11 tools that think, 3 slash-command workflows, and a bundled Claude Skill. Not another API wrapper.
4
+
5
+ Maintained successor to [JoshuaRileyDev/app-store-connect-mcp-server](https://github.com/JoshuaRileyDev/app-store-connect-mcp-server) (archived Feb 2026). Different angle, same API surface plus more.
4
6
 
5
7
  ```bash
6
8
  npm install -g @pofky/asc-mcp
9
+ asc-mcp install-skill # one-line, optional, for auto-routed review questions
7
10
  ```
8
11
 
9
12
  ## What Makes This Different
10
13
 
11
- Other ASC MCP servers wrap the API and give you 80-293 raw endpoints. This one gives you 8 tools that think:
14
+ Other ASC MCP servers wrap the API and give you 80 to 293 raw endpoints. This one gives you 11 tools plus 3 Prompts plus a Skill that all think:
12
15
 
13
16
  | You say | What happens |
14
17
  |---------|-------------|
@@ -72,11 +75,38 @@ Works with **Claude Code**, **Cursor**, **Windsurf**, **Cline**, and any MCP-com
72
75
  | `release_preflight` | Pre-submission audit: metadata, char limits, screenshots, builds | Catches 40%+ of common rejection causes before you submit |
73
76
  | `daily_briefing` | Morning summary across all apps: status, reviews, rejections | One call replaces 10 minutes of portal clicking |
74
77
  | `release_notes` | Git commits since last tag, categorized for writing "What's New" | Your AI agent writes release notes from your actual changes |
78
+ | `keyword_insights` | Analyze keywords against iTunes search competition, difficulty ratings | See which keywords are worth targeting at a glance |
79
+ | `competitor_snapshot` | Look up any app: ratings, reviews, version, price, release notes | Competitive intelligence without leaving your editor |
80
+ | `metadata_diff` | Compare live vs pending version metadata across all locales | Verify exactly what changed before submitting |
75
81
 
76
- **Coming next:** review response drafting, keyword/ASO insights, competitor snapshots.
82
+ **Coming next (Week 2):** LLM-powered review clustering via MCP Sampling, Elicitation-driven response drafts, rejection-risk scoring against the 2026 corpus.
77
83
 
78
84
  [Get Pro](https://buy.polar.sh/polar_cl_Ta3OxEA1EbRyYNPFtSsRXgYWBCCtjwMxlbAeW35RLuu) | [Retrieve your license key](https://asc-mcp-license.remewdy.workers.dev/key)
79
85
 
86
+ ## Slash Commands (Prompts)
87
+
88
+ Type these in Claude Desktop or Claude Code and the agent runs a pre-built multi-tool workflow:
89
+
90
+ | Slash command | What it does |
91
+ |---------------|--------------|
92
+ | `/asc-weekly-review` | Calls `daily_briefing` then `list_reviews` (low-rating, last 7 days) for every app, clusters themes, returns a single digest with 3-bullet action list. |
93
+ | `/asc-rejection-audit` | Given an `app_id`, calls `release_preflight` + `metadata_diff` + `review_status`, reads the result against the top 2026 rejection drivers (guideline 2.3 metadata, 4.0 design, privacy-AI 5.1.2). Produces Blocking / Likely-flagged / Safe sections. |
94
+ | `/asc-release-go-no-go` | Given an `app_id`, combines preflight + review queue + metadata diff + top competitors in the same category. Returns a direct GO or NO-GO with three supporting reasons. |
95
+
96
+ These are MCP Prompts per the [spec](https://modelcontextprotocol.io/docs/concepts/prompts/). Zero other App Store Connect MCP ships with them.
97
+
98
+ ## Claude Skill (one-line install)
99
+
100
+ After installing the MCP, run:
101
+
102
+ ```bash
103
+ asc-mcp install-skill
104
+ ```
105
+
106
+ This copies a small `asc-review-triage` Skill to `~/.claude/skills/` so Claude automatically picks up review-related questions ("any bad reviews lately?", "what do my users say?", "ratings this week?") and calls the right ASC tools without you having to explain the workflow each time.
107
+
108
+ Works on macOS, Linux, and Windows. To remove: `asc-mcp uninstall-skill`.
109
+
80
110
  ## Real Output Examples
81
111
 
82
112
  **"Run a preflight check before I submit"**
@@ -141,13 +171,15 @@ Lead with the most impactful change. Keep under 4000 chars.
141
171
 
142
172
  | | Raw API wrappers (free) | This server |
143
173
  |---|---|---|
144
- | **Tool count** | 80-293 | 8 |
145
- | **Pre-submission audit** | No | Yes - catches rejections before you submit |
146
- | **Cross-app briefings** | No | Yes - one call, all apps |
147
- | **Git-aware release notes** | No | Yes - reads your project's commit history |
148
- | **Smart review summaries** | No | Yes - sentiment grouping, action items |
149
- | **Setup** | Build from source (Swift/macOS) | `npm install -g` (any OS) |
150
- | **Free tier** | Some | Yes - 3 tools, no account needed |
174
+ | **Tool count** | 80 to 293 | 11 opinionated tools |
175
+ | **MCP Prompts (slash commands)** | No | Yes, 3 pre-built workflows |
176
+ | **Claude Skill bundled** | No | Yes, one-line install |
177
+ | **Pre-submission audit** | No | Yes, catches rejections before you submit |
178
+ | **Cross-app briefings** | No | Yes, one call, all apps |
179
+ | **Git-aware release notes** | No | Yes, reads your project's commit history |
180
+ | **Smart review summaries** | No | Yes, theme clustering, action items |
181
+ | **Setup** | Build from source (Swift or Node) | `npm install -g` (any OS) |
182
+ | **Free tier** | Some | Yes, 3 tools, no account needed |
151
183
 
152
184
  Raw wrappers give you endpoints. This gives you answers.
153
185
 
package/dist/index.js CHANGED
@@ -6,6 +6,8 @@ const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
6
6
  const zod_1 = require("zod");
7
7
  const client_js_1 = require("./client.js");
8
8
  const license_js_1 = require("./license.js");
9
+ const prompts_js_1 = require("./prompts.js");
10
+ const skill_installer_js_1 = require("./skill-installer.js");
9
11
  const list_apps_js_1 = require("./tools/list-apps.js");
10
12
  const app_details_js_1 = require("./tools/app-details.js");
11
13
  const review_status_js_1 = require("./tools/review-status.js");
@@ -17,6 +19,7 @@ const release_notes_js_1 = require("./tools/release-notes.js");
17
19
  const keyword_insights_js_1 = require("./tools/keyword-insights.js");
18
20
  const competitor_snapshot_js_1 = require("./tools/competitor-snapshot.js");
19
21
  const metadata_diff_js_1 = require("./tools/metadata-diff.js");
22
+ const SERVER_VERSION = "1.2.0";
20
23
  function getConfig() {
21
24
  const keyId = process.env.ASC_KEY_ID;
22
25
  const issuerId = process.env.ASC_ISSUER_ID;
@@ -42,14 +45,19 @@ async function main() {
42
45
  const client = new client_js_1.ASCClient(config);
43
46
  const tier = await (0, license_js_1.validateLicense)(config.licenseKey);
44
47
  if (tier === "pro") {
45
- console.error("asc-mcp: Pro license active. All tools available.");
48
+ console.error(`asc-mcp ${SERVER_VERSION}: Pro license active. All tools available.`);
46
49
  }
47
50
  else {
48
- console.error("asc-mcp: Free tier (3 tools). Upgrade at https://buy.polar.sh/polar_cl_Ta3OxEA1EbRyYNPFtSsRXgYWBCCtjwMxlbAeW35RLuu");
51
+ console.error(`asc-mcp ${SERVER_VERSION}: Free tier (3 tools). Upgrade at https://buy.polar.sh/polar_cl_Ta3OxEA1EbRyYNPFtSsRXgYWBCCtjwMxlbAeW35RLuu`);
49
52
  }
50
53
  const server = new mcp_js_1.McpServer({
51
54
  name: "asc-mcp",
52
- version: "0.1.0",
55
+ version: SERVER_VERSION,
56
+ }, {
57
+ capabilities: {
58
+ tools: {},
59
+ prompts: {},
60
+ },
53
61
  });
54
62
  // --- Free tools ---
55
63
  /** Wrap a tool handler so API errors return messages instead of crashing. */
@@ -101,9 +109,41 @@ async function main() {
101
109
  server.tool("metadata_diff", "Compare metadata between your live and pending app versions. Shows what changed in descriptions, keywords, and release notes across locales.", {
102
110
  app_id: zod_1.z.string().regex(/^\d+$/, "App ID must be numeric").describe("App Store Connect app ID"),
103
111
  }, safe((args) => (0, metadata_diff_js_1.metadataDiff)(client, args, tier)));
112
+ // --- Prompts (slash commands in Claude Desktop / Code) ---
113
+ const prompts = (0, prompts_js_1.registerPrompts)(server);
114
+ console.error(`asc-mcp: ${prompts.length} prompt(s) registered: ${prompts.map((p) => "/" + p.name).join(", ")}`);
104
115
  const transport = new stdio_js_1.StdioServerTransport();
105
116
  await server.connect(transport);
106
117
  }
118
+ function dispatchCli(argv) {
119
+ const cmd = argv[2];
120
+ if (!cmd)
121
+ return null;
122
+ if (cmd === "install-skill")
123
+ return (0, skill_installer_js_1.installSkill)();
124
+ if (cmd === "uninstall-skill")
125
+ return (0, skill_installer_js_1.uninstallSkill)();
126
+ if (cmd === "--version" || cmd === "-v" || cmd === "version") {
127
+ console.log(SERVER_VERSION);
128
+ return 0;
129
+ }
130
+ if (cmd === "--help" || cmd === "-h" || cmd === "help") {
131
+ console.log(`asc-mcp ${SERVER_VERSION}
132
+
133
+ Usage:
134
+ asc-mcp Run as an MCP server on stdio (for Claude Desktop/Code).
135
+ asc-mcp install-skill Install the asc-review-triage Claude Skill.
136
+ asc-mcp uninstall-skill Remove the asc-review-triage Claude Skill.
137
+ asc-mcp version Print version.
138
+ asc-mcp help This help.`);
139
+ return 0;
140
+ }
141
+ return null;
142
+ }
143
+ const cliResult = dispatchCli(process.argv);
144
+ if (cliResult !== null) {
145
+ process.exit(cliResult);
146
+ }
107
147
  main().catch((err) => {
108
148
  console.error("Fatal error:", err);
109
149
  process.exit(1);
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,16 @@
1
+ /**
2
+ * MCP Prompts for @pofky/asc-mcp.
3
+ *
4
+ * Prompts appear as slash commands in Claude Desktop and Claude Code.
5
+ * Each prompt seeds the conversation with a message that coaches Claude
6
+ * on the exact ASC tool sequence to run. This is the "procedural
7
+ * knowledge" layer competing MCPs skip.
8
+ */
9
+ import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
10
+ export interface PromptRegistration {
11
+ name: string;
12
+ title: string;
13
+ description: string;
14
+ }
15
+ export declare function registerPrompts(server: McpServer): PromptRegistration[];
16
+ //# sourceMappingURL=prompts.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB;AAOD,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,GAAG,kBAAkB,EAAE,CA6HvE"}
@@ -0,0 +1,124 @@
1
+ "use strict";
2
+ /**
3
+ * MCP Prompts for @pofky/asc-mcp.
4
+ *
5
+ * Prompts appear as slash commands in Claude Desktop and Claude Code.
6
+ * Each prompt seeds the conversation with a message that coaches Claude
7
+ * on the exact ASC tool sequence to run. This is the "procedural
8
+ * knowledge" layer competing MCPs skip.
9
+ */
10
+ Object.defineProperty(exports, "__esModule", { value: true });
11
+ exports.registerPrompts = registerPrompts;
12
+ const zod_1 = require("zod");
13
+ const APP_ID_SCHEMA = zod_1.z
14
+ .string()
15
+ .regex(/^\d+$/, "App ID must be numeric. Use `list_apps` if you don't know it.")
16
+ .describe("App Store Connect app ID, numeric (use list_apps if unknown)");
17
+ function registerPrompts(server) {
18
+ const registered = [];
19
+ const weekly = server.registerPrompt("asc-weekly-review", {
20
+ title: "Weekly App Store review",
21
+ description: "One-click weekly summary across all your App Store Connect apps: version status, new low-rating reviews in the last 7 days, rejections, and action items. Calls daily_briefing then list_reviews (rating<=3) and synthesizes.",
22
+ }, () => ({
23
+ description: "Weekly review across all apps",
24
+ messages: [
25
+ {
26
+ role: "user",
27
+ content: {
28
+ type: "text",
29
+ text: [
30
+ "Give me a weekly App Store review across all my apps. Use the asc-mcp tools in this exact order and present a single concise summary at the end:",
31
+ "",
32
+ "1. Call `daily_briefing` with `days: 7` to get the situational overview (review status, rejections, action items).",
33
+ "2. Call `list_apps` to get the full list of app IDs if the briefing did not cover every app.",
34
+ "3. For each app that has `status: in_review` or that the briefing flagged, call `review_status` to confirm the current state.",
35
+ "4. For each app, call `list_reviews` with `rating: 3`, `sort: newest`, `limit: 20` to pull low-rating reviews from the last 7 days.",
36
+ "5. Cluster low-rating reviews by theme (bugs, pricing, missing feature, etc.). Keep to 3 to 5 clusters.",
37
+ "6. Produce a final digest with: apps in review, apps rejected, top 3 review themes with counts, and a 3-bullet action list for the coming week.",
38
+ "",
39
+ "Do not invent numbers. If a tool fails, say so and continue with the rest.",
40
+ ].join("\n"),
41
+ },
42
+ },
43
+ ],
44
+ }));
45
+ registered.push({
46
+ name: "asc-weekly-review",
47
+ title: weekly.title ?? "",
48
+ description: weekly.description ?? "",
49
+ });
50
+ const audit = server.registerPrompt("asc-rejection-audit", {
51
+ title: "Pre-submission rejection audit",
52
+ description: "Catch likely rejection causes before you submit. Runs release_preflight, then metadata_diff, then review_status, and reads results against the top 2026 rejection drivers (guideline 2.3 metadata, 4.0 design, privacy-AI 5.1.2).",
53
+ argsSchema: { app_id: APP_ID_SCHEMA },
54
+ }, ({ app_id }) => ({
55
+ description: `Rejection audit for app ${app_id}`,
56
+ messages: [
57
+ {
58
+ role: "user",
59
+ content: {
60
+ type: "text",
61
+ text: [
62
+ `Run a pre-submission rejection audit for App Store Connect app ${app_id}. Use the asc-mcp tools in this order:`,
63
+ "",
64
+ `1. Call \`release_preflight\` with \`app_id: "${app_id}"\` to audit metadata, character limits, screenshots, and build status.`,
65
+ `2. Call \`metadata_diff\` with \`app_id: "${app_id}"\` to see exactly what is changing between the live and pending version across all locales.`,
66
+ `3. Call \`review_status\` with \`app_id: "${app_id}"\` to confirm the current submission state.`,
67
+ "",
68
+ "Read the combined output against the top 2026 rejection drivers:",
69
+ "- Guideline 2.3 (inaccurate metadata: broken links, stale screenshots, placeholder text)",
70
+ "- Guideline 4.0 (design: minimum content, broken flows, missing signup)",
71
+ "- Guideline 5.1.2 (data use, privacy-AI: missing SDK disclosures, tracking permissions)",
72
+ "",
73
+ "Produce a report with three sections: (a) Blocking issues (fix before submit), (b) Likely-flagged items (judgment call), (c) Safe. Quote exact metadata lines that trigger each concern.",
74
+ "",
75
+ "Do not invent rejection reasons. If preflight finds zero issues and metadata_diff is clean, say 'no blocking issues found'.",
76
+ ].join("\n"),
77
+ },
78
+ },
79
+ ],
80
+ }));
81
+ registered.push({
82
+ name: "asc-rejection-audit",
83
+ title: audit.title ?? "",
84
+ description: audit.description ?? "",
85
+ });
86
+ const goNoGo = server.registerPrompt("asc-release-go-no-go", {
87
+ title: "Release go/no-go",
88
+ description: "Decide whether to ship a release today. Combines release_preflight, review_status, metadata_diff, and competitor_snapshot to produce a single GO or NO-GO recommendation with reasoning.",
89
+ argsSchema: { app_id: APP_ID_SCHEMA },
90
+ }, ({ app_id }) => ({
91
+ description: `Go/no-go decision for app ${app_id}`,
92
+ messages: [
93
+ {
94
+ role: "user",
95
+ content: {
96
+ type: "text",
97
+ text: [
98
+ `Decide whether to ship a release today for App Store Connect app ${app_id}. Use the asc-mcp tools in this order:`,
99
+ "",
100
+ `1. Call \`release_preflight\` with \`app_id: "${app_id}"\`.`,
101
+ `2. Call \`review_status\` with \`app_id: "${app_id}"\`.`,
102
+ `3. Call \`metadata_diff\` with \`app_id: "${app_id}"\`.`,
103
+ `4. Call \`app_details\` with \`app_id: "${app_id}"\` to read category and name.`,
104
+ "5. Call `competitor_snapshot` with the same category's top two competitors (use what you know) to see if anyone else just shipped a bigger release today.",
105
+ "",
106
+ "Produce a single GO or NO-GO with three supporting bullets:",
107
+ "- Preflight verdict (blocking issues y/n)",
108
+ "- Queue verdict (is the existing version still in review? if yes, hold)",
109
+ "- Market window (did a big competitor ship today? if yes, consider holding one day)",
110
+ "",
111
+ "Be direct. If unsure, say NO-GO and explain why. Do not hedge.",
112
+ ].join("\n"),
113
+ },
114
+ },
115
+ ],
116
+ }));
117
+ registered.push({
118
+ name: "asc-release-go-no-go",
119
+ title: goNoGo.title ?? "",
120
+ description: goNoGo.description ?? "",
121
+ });
122
+ return registered;
123
+ }
124
+ //# sourceMappingURL=prompts.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"prompts.js","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,10 @@
1
+ /**
2
+ * `asc-mcp install-skill` and `asc-mcp uninstall-skill` subcommands.
3
+ *
4
+ * Copies (or removes) the bundled `asc-review-triage` Claude Skill to
5
+ * ~/.claude/skills/asc-review-triage/ so Claude Desktop and Claude Code
6
+ * auto-load it.
7
+ */
8
+ export declare function installSkill(): number;
9
+ export declare function uninstallSkill(): number;
10
+ //# sourceMappingURL=skill-installer.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"skill-installer.d.ts","sourceRoot":"","sources":["../src/skill-installer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAuCH,wBAAgB,YAAY,IAAI,MAAM,CA0CrC;AAED,wBAAgB,cAAc,IAAI,MAAM,CAgBvC"}
@@ -0,0 +1,104 @@
1
+ "use strict";
2
+ /**
3
+ * `asc-mcp install-skill` and `asc-mcp uninstall-skill` subcommands.
4
+ *
5
+ * Copies (or removes) the bundled `asc-review-triage` Claude Skill to
6
+ * ~/.claude/skills/asc-review-triage/ so Claude Desktop and Claude Code
7
+ * auto-load it.
8
+ */
9
+ var __importDefault = (this && this.__importDefault) || function (mod) {
10
+ return (mod && mod.__esModule) ? mod : { "default": mod };
11
+ };
12
+ Object.defineProperty(exports, "__esModule", { value: true });
13
+ exports.installSkill = installSkill;
14
+ exports.uninstallSkill = uninstallSkill;
15
+ const node_fs_1 = __importDefault(require("node:fs"));
16
+ const node_path_1 = __importDefault(require("node:path"));
17
+ const node_os_1 = __importDefault(require("node:os"));
18
+ const SKILL_NAME = "asc-review-triage";
19
+ function targetDir() {
20
+ return node_path_1.default.join(node_os_1.default.homedir(), ".claude", "skills", SKILL_NAME);
21
+ }
22
+ function sourceDir() {
23
+ // When compiled, __dirname maps to dist/. The skills/ dir ships at
24
+ // the package root, one level up. CommonJS build uses __dirname.
25
+ return node_path_1.default.resolve(__dirname, "..", "skills", SKILL_NAME);
26
+ }
27
+ function ensureDir(dir) {
28
+ node_fs_1.default.mkdirSync(dir, { recursive: true });
29
+ }
30
+ function copyDirRecursive(src, dest) {
31
+ ensureDir(dest);
32
+ const written = [];
33
+ const entries = node_fs_1.default.readdirSync(src, { withFileTypes: true });
34
+ for (const entry of entries) {
35
+ const s = node_path_1.default.join(src, entry.name);
36
+ const d = node_path_1.default.join(dest, entry.name);
37
+ if (entry.isDirectory()) {
38
+ written.push(...copyDirRecursive(s, d));
39
+ }
40
+ else if (entry.isFile()) {
41
+ node_fs_1.default.copyFileSync(s, d);
42
+ written.push(d);
43
+ }
44
+ }
45
+ return written;
46
+ }
47
+ function installSkill() {
48
+ const src = sourceDir();
49
+ const dest = targetDir();
50
+ if (!node_fs_1.default.existsSync(src)) {
51
+ console.error(`[asc-mcp] skill source not found at ${src}`);
52
+ console.error("[asc-mcp] this is a packaging bug, please open an issue.");
53
+ return 1;
54
+ }
55
+ try {
56
+ console.log(`Installing ${SKILL_NAME} skill for Claude Desktop / Claude Code.`);
57
+ console.log("");
58
+ console.log(`Writing to ${dest}`);
59
+ const homeClaude = node_path_1.default.join(node_os_1.default.homedir(), ".claude");
60
+ const homeClaudeExisted = node_fs_1.default.existsSync(homeClaude);
61
+ const skillsParentExisted = node_fs_1.default.existsSync(node_path_1.default.dirname(dest));
62
+ ensureDir(dest);
63
+ const written = copyDirRecursive(src, dest);
64
+ console.log(` ${homeClaudeExisted ? " " : "+"} ~/.claude/ ${homeClaudeExisted ? "already existed" : "created"}`);
65
+ console.log(` ${skillsParentExisted ? " " : "+"} ~/.claude/skills/ ${skillsParentExisted ? "already existed" : "created"}`);
66
+ for (const f of written) {
67
+ console.log(` + ${node_path_1.default.relative(node_os_1.default.homedir(), f)}`);
68
+ }
69
+ console.log("");
70
+ console.log("Done. The skill is now active.");
71
+ console.log("");
72
+ console.log("Next: in Claude Desktop or Claude Code, try asking");
73
+ console.log(' "any bad reviews on my app lately?"');
74
+ console.log("Claude will auto-load the skill and call the right tools.");
75
+ console.log("");
76
+ console.log("If Claude does not pick it up, restart the client once.");
77
+ console.log("To remove: asc-mcp uninstall-skill");
78
+ return 0;
79
+ }
80
+ catch (err) {
81
+ const msg = err instanceof Error ? err.message : String(err);
82
+ console.error(`[asc-mcp] install failed: ${msg}`);
83
+ return 1;
84
+ }
85
+ }
86
+ function uninstallSkill() {
87
+ const dest = targetDir();
88
+ if (!node_fs_1.default.existsSync(dest)) {
89
+ console.log(`No ${SKILL_NAME} skill found at ${dest}. Nothing to do.`);
90
+ return 0;
91
+ }
92
+ try {
93
+ node_fs_1.default.rmSync(dest, { recursive: true, force: true });
94
+ console.log(`Removed ${dest}`);
95
+ console.log("Restart Claude Desktop or Claude Code to unload the skill.");
96
+ return 0;
97
+ }
98
+ catch (err) {
99
+ const msg = err instanceof Error ? err.message : String(err);
100
+ console.error(`[asc-mcp] uninstall failed: ${msg}`);
101
+ return 1;
102
+ }
103
+ }
104
+ //# sourceMappingURL=skill-installer.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"skill-installer.js","sourceRoot":"","sources":["../src/skill-installer.ts"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@pofky/asc-mcp",
3
- "version": "1.1.0",
4
- "description": "MCP server for Apple App Store Connect API - check review status, read customer reviews, download sales reports, pre-submission audit, daily briefings. Works with Claude Code, Cursor, Windsurf, or any AI coding agent. Free tier included.",
3
+ "version": "1.2.0",
4
+ "description": "The App Store Connect intelligence layer for your coding agent. 11 tools, 3 slash-command Prompts, and a bundled Claude Skill. Works with Claude Code, Claude Desktop, Cursor, Windsurf, or any MCP-compatible client. Free tier included.",
5
5
  "main": "dist/index.js",
6
6
  "bin": {
7
7
  "asc-mcp": "dist/index.js",
@@ -57,6 +57,7 @@
57
57
  },
58
58
  "files": [
59
59
  "dist/",
60
+ "skills/",
60
61
  "README.md",
61
62
  "LICENSE"
62
63
  ]
@@ -0,0 +1,58 @@
1
+ ---
2
+ name: asc-review-triage
3
+ description: Use this skill whenever the user asks about App Store reviews, ratings, customer feedback, low-star reviews, reviewer sentiment, or what users are saying about an iOS or macOS app. Queries the asc-mcp server to pull and analyze reviews. Trigger on phrases like "any bad reviews", "what do my users say", "reviews this week", "1-star", "2-star", "3-star", "customer feedback", "ratings trend", "reviewer sentiment".
4
+ ---
5
+
6
+ # App Store review triage
7
+
8
+ When the user asks about reviews, ratings, or customer feedback for their App Store apps, follow this procedure using the `asc-mcp` tools.
9
+
10
+ ## Step 1. Identify the app
11
+
12
+ If the user specified an app name or ID, use it. Otherwise:
13
+
14
+ 1. Call `list_apps` to get the full list.
15
+ 2. If there is only one app, use it.
16
+ 3. If there are several, ask the user which app they mean. Do not guess.
17
+
18
+ ## Step 2. Pull reviews
19
+
20
+ Call `list_reviews` with:
21
+
22
+ - `app_id`: the app ID from step 1
23
+ - `rating`: 3 (covers 1, 2, and 3 star reviews when sorted correctly)
24
+ - `sort`: `newest`
25
+ - `limit`: 20 for a quick scan, up to 100 for a deep dive
26
+
27
+ If the user specifically asked about 1-star reviews only, set `rating: 1`. If they asked about all reviews (positive and negative), call `list_reviews` without a rating filter.
28
+
29
+ ## Step 3. Confirm review status
30
+
31
+ Call `review_status` with the same `app_id`. This tells the user whether a new version is in review or waiting, which often correlates with review-score dips.
32
+
33
+ ## Step 4. Summarize
34
+
35
+ Produce a concise summary with:
36
+
37
+ - Total reviews in the window
38
+ - Breakdown by rating (1, 2, 3, 4, 5)
39
+ - 3 to 5 themes, each with a review-count and one representative quote
40
+ - Any single review flagged as potentially actionable (specific bug report, feature request, competitor mention)
41
+ - The current review-queue status from step 3
42
+
43
+ ## Guardrails
44
+
45
+ - Do not invent reviews. Quote only what `list_reviews` returned.
46
+ - Do not post a reply. This skill reads only. Drafting or posting responses is a separate Pro feature not in this skill.
47
+ - If `list_reviews` returns nothing, say so plainly.
48
+ - If the user does not have a Pro license (free tier), `list_reviews` will error. Explain the free-tier limit and link to https://buy.polar.sh/polar_cl_Ta3OxEA1EbRyYNPFtSsRXgYWBCCtjwMxlbAeW35RLuu.
49
+
50
+ ## Example usage
51
+
52
+ User: "Any bad reviews on my meditation app this week?"
53
+
54
+ Claude:
55
+ 1. Calls `list_apps`, finds one app called "Meditation Timer".
56
+ 2. Calls `list_reviews` with that app ID, rating 3, newest first, limit 20.
57
+ 3. Calls `review_status`.
58
+ 4. Returns: "7 reviews in the last 7 days, average 2.3 stars. 3 themes: crashes on iOS 18.2 (4 reviews), missing dark mode (2 reviews), confusion over premium tier (1 review). The version 2.4.1 submission is currently In Review (submitted 2 days ago)."