Pabal MCP

Instructions

Input Schema

Input Schema (JSON Schema)

Implementation Reference

• src/tools/release/pull-notes.ts:32-222 (handler)

  Main handler function `handleAsoPullReleaseNotes` that resolves the app, fetches release notes from App Store and/or Google Play services, logs progress, handles dry-run, and saves to local files if not dry-run.
  export async function handleAsoPullReleaseNotes( options: AsoPullReleaseNotesOptions ) { const { app, store, dryRun = false } = options; let { packageName, bundleId } = options; const { store: targetStore, includeAppStore, includeGooglePlay, } = getStoreTargets(store); const resolved = appResolutionService.resolve({ slug: app, packageName, bundleId, }); if (!resolved.success) { return { content: [ { type: "text" as const, text: resolved.error.message, }, ], }; } const { slug, bundleId: resolvedBundleId, packageName: resolvedPackageName, hasAppStore, hasGooglePlay, } = resolved.data; bundleId = resolvedBundleId; packageName = resolvedPackageName; console.error(`[MCP] 📥 Pulling release notes`); console.error(`[MCP] Store: ${targetStore}`); console.error(`[MCP] App: ${slug}`); if (packageName) console.error(`[MCP] Package Name: ${packageName}`); if (bundleId) console.error(`[MCP] Bundle ID: ${bundleId}`); console.error(`[MCP] Mode: ${dryRun ? "Dry run" : "Actual fetch"}`); let config; try { config = loadConfig(); } catch (error) { const message = error instanceof Error ? error.message : String(error); return { content: [ { type: "text" as const, text: `❌ Failed to load config: ${message}`, }, ], isError: true, }; } const releaseNotes: { googlePlay?: GooglePlayReleaseNote[]; appStore?: AppStoreReleaseNote[]; } = {}; if (includeGooglePlay) { if (!hasGooglePlay) { console.error( `[MCP] ⏭️ Skipping Google Play (not registered for Google Play)` ); } else if (!config.playStore) { console.error( `[MCP] ⏭️ Skipping Google Play (not configured in ~/.config/pabal-mcp/config.json)` ); } else if (!packageName) { console.error( `[MCP] ⏭️ Skipping Google Play (no packageName provided)` ); } else { const notesResult = await googlePlayService.pullReleaseNotes(packageName); if (!notesResult.success) { console.error( `[MCP] ❌ Failed to fetch Google Play release notes: ${notesResult.error.message}` ); } else { releaseNotes.googlePlay = notesResult.data; console.error(`[MCP] 📊 Google Play Release Notes:`); console.error(`[MCP] Total versions: ${notesResult.data.length}`); for (const rn of notesResult.data) { const code = (rn as any).versionCode ?? "N/A"; console.error( `[MCP] Version ${rn.versionName} (${code}): ${ Object.keys(rn.releaseNotes).length } languages` ); } console.error(`[MCP] ✅ Google Play release notes fetched`); } } } if (includeAppStore) { if (!hasAppStore) { console.error( `[MCP] ⏭️ Skipping App Store (not registered for App Store)` ); } else if (!config.appStore) { console.error( `[MCP] ⏭️ Skipping App Store (not configured in ~/.config/pabal-mcp/config.json)` ); } else if (!bundleId) { console.error(`[MCP] ⏭️ Skipping App Store (no bundleId provided)`); } else { const notesResult = await appStoreService.pullReleaseNotes(bundleId); if (!notesResult.success) { console.error( `[MCP] ❌ Failed to fetch App Store release notes: ${notesResult.error.message}` ); } else { releaseNotes.appStore = notesResult.data; console.error(`[MCP] 📊 App Store Release Notes:`); console.error(`[MCP] Total versions: ${notesResult.data.length}`); for (const rn of notesResult.data) { console.error( `[MCP] Version ${rn.versionString}: ${ Object.keys(rn.releaseNotes).length } locales` ); } console.error(`[MCP] ✅ App Store release notes fetched`); } } } if (dryRun) { return { content: [ { type: "text" as const, text: `📋 Dry run - Release notes:\n${JSON.stringify( releaseNotes, null, 2 )}`, }, ], }; } // Save to ASO directory const asoDir = getPullProductAsoDir(slug, getAsoPullDir()); if (releaseNotes.googlePlay) { const googlePlayDir = getStoreDir(asoDir, "google-play"); ensureDir(googlePlayDir); const filePath = getReleaseNotesPath(googlePlayDir); writeFileSync(filePath, JSON.stringify(releaseNotes.googlePlay, null, 2)); console.error(`[MCP] 💾 Google Play release notes saved to ${filePath}`); } if (releaseNotes.appStore) { const appStoreDir = getStoreDir(asoDir, "app-store"); ensureDir(appStoreDir); const filePath = getReleaseNotesPath(appStoreDir); writeFileSync(filePath, JSON.stringify(releaseNotes.appStore, null, 2)); console.error(`[MCP] 💾 App Store release notes saved to ${filePath}`); } return { content: [ { type: "text" as const, text: `✅ Release notes pulled\n` + ` Google Play: ${ releaseNotes.googlePlay ? `${releaseNotes.googlePlay.length} versions` : "✗" }\n` + ` App Store: ${ releaseNotes.appStore ? `${releaseNotes.appStore.length} versions` : "✗" }`, }, ], }; }
• src/index.ts:327-344 (registration)

  Registers the tool 'release-pull-notes' with MCP server, including description, Zod input schema, and references the handler function.
  registerToolWithInfo( "release-pull-notes", { description: "Fetch release notes from App Store/Google Play.", inputSchema: z.object({ app: z.string().optional().describe("Registered app slug"), packageName: z.string().optional().describe("Google Play package name"), bundleId: z.string().optional().describe("App Store bundle ID"), store: storeSchema.describe("Target store (default: both)"), dryRun: z .boolean() .optional() .describe("If true, only outputs result without actually saving"), }), }, handleAsoPullReleaseNotes, "Release Management" );
• src/tools/release/pull-notes.ts:24-30 (schema)

  TypeScript interface defining the input options for the handler function.
  interface AsoPullReleaseNotesOptions { app?: string; // Registered app slug packageName?: string; // For Google Play bundleId?: string; // For App Store store?: StoreType; dryRun?: boolean; }