get_app_details
Retrieve detailed metadata for apps on iOS and Android platforms by specifying the app ID, platform, country, and language. Ideal for analyzing app details and store-specific data.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| appId | Yes | The unique identifier for the app. For Android: the package name (e.g., 'com.google.android.gm'). For iOS: the numeric ID (e.g., '553834731') or the bundle ID (e.g., 'com.midasplayer.apps.candycrushsaga'). | |
| country | No | Two-letter country code for store localization (e.g., 'us', 'de'). Affects availability and potentially some metadata. Default 'us'. | us |
| lang | No | Language code for the results (e.g., 'en', 'de'). If not provided, defaults to the 'country' code. If 'country' is also missing, defaults to 'en'. Determines the language of text fields like description and recent changes. | en |
| platform | Yes | The platform of the app ('ios' or 'android'). |
Implementation Reference
- server.js:154-270 (handler)The main handler function for the get_app_details tool. It fetches detailed app information from either Google Play Store (using memoizedGplay.app) or Apple App Store (using memoizedAppStore.app), normalizes the data for consistency across platforms, and returns JSON-formatted details including title, developer, ratings, pricing, screenshots, and more. Handles both Android package names and iOS numeric/bundle IDs.async ({ appId, platform, country, lang }) => { try { let appDetails; if (platform === "android") { // Get app details from Google Play Store appDetails = await memoizedGplay.app({ appId, country, lang }); // Normalize Android app details appDetails = { id: appDetails.appId, appId: appDetails.appId, title: appDetails.title, description: appDetails.description, summary: appDetails.summary, developer: appDetails.developer, developerId: appDetails.developerId, developerEmail: appDetails.developerEmail, developerWebsite: appDetails.developerWebsite, icon: appDetails.icon, headerImage: appDetails.headerImage, screenshots: appDetails.screenshots, score: appDetails.score, scoreText: appDetails.scoreText, ratings: appDetails.ratings, reviews: appDetails.reviews, histogram: appDetails.histogram, price: appDetails.price, free: appDetails.free, currency: appDetails.currency, categories: appDetails.categories, genre: appDetails.genre, genreId: appDetails.genreId, contentRating: appDetails.contentRating, released: appDetails.released, updated: appDetails.updated, version: appDetails.version, size: appDetails.size, recentChanges: appDetails.recentChanges, platform: "android" }; } else { // Get app details from Apple App Store // For iOS, we need to handle both numeric IDs and bundle IDs const isNumericId = /^\d+$/.test(appId); const lookupParams = isNumericId ? { id: appId, country, lang } : { appId: appId, country, lang }; appDetails = await memoizedAppStore.app({ ...lookupParams, ratings: true // Get ratings information too }); // Normalize iOS app details appDetails = { id: appDetails.id.toString(), appId: appDetails.appId, title: appDetails.title, description: appDetails.description, summary: appDetails.description?.substring(0, 100), developer: appDetails.developer, developerId: appDetails.developerId, developerWebsite: appDetails.developerWebsite, icon: appDetails.icon, screenshots: appDetails.screenshots, ipadScreenshots: appDetails.ipadScreenshots, score: appDetails.score, scoreText: appDetails.score?.toString(), ratings: appDetails.ratings, reviews: appDetails.reviews, histogram: appDetails.histogram, price: appDetails.price, free: appDetails.free, currency: appDetails.currency, genres: appDetails.genres, primaryGenre: appDetails.primaryGenre, contentRating: appDetails.contentRating, released: appDetails.released, updated: appDetails.updated, version: appDetails.version, size: appDetails.size, releaseNotes: appDetails.releaseNotes, platform: "ios" }; } return { content: [{ type: "text", text: JSON.stringify({ appId, platform, details: appDetails }, null, 2) }] }; } catch (error) { return { content: [{ type: "text", text: JSON.stringify({ error: error.message, appId, platform }, null, 2) }], isError: true }; } } );
- server.js:148-153 (schema)Input schema using Zod validation for the get_app_details tool parameters: appId (required string), platform (ios/android enum), country (optional 2-letter code, default 'us'), lang (optional language code, default 'en').{ appId: z.string().describe("The unique identifier for the app. For Android: the package name (e.g., 'com.google.android.gm'). For iOS: the numeric ID (e.g., '553834731') or the bundle ID (e.g., 'com.midasplayer.apps.candycrushsaga')."), platform: z.enum(["ios", "android"]).describe("The platform of the app ('ios' or 'android')."), country: z.string().length(2).optional().default("us").describe("Two-letter country code for store localization (e.g., 'us', 'de'). Affects availability and potentially some metadata. Default 'us'."), lang: z.string().optional().default("en").describe("Language code for the results (e.g., 'en', 'de'). If not provided, defaults to the 'country' code. If 'country' is also missing, defaults to 'en'. Determines the language of text fields like description and recent changes.") },
- server.js:146-270 (registration)MCP server tool registration call using server.tool() that defines the 'get_app_details' tool with its input schema and handler function.server.tool( "get_app_details", { appId: z.string().describe("The unique identifier for the app. For Android: the package name (e.g., 'com.google.android.gm'). For iOS: the numeric ID (e.g., '553834731') or the bundle ID (e.g., 'com.midasplayer.apps.candycrushsaga')."), platform: z.enum(["ios", "android"]).describe("The platform of the app ('ios' or 'android')."), country: z.string().length(2).optional().default("us").describe("Two-letter country code for store localization (e.g., 'us', 'de'). Affects availability and potentially some metadata. Default 'us'."), lang: z.string().optional().default("en").describe("Language code for the results (e.g., 'en', 'de'). If not provided, defaults to the 'country' code. If 'country' is also missing, defaults to 'en'. Determines the language of text fields like description and recent changes.") }, async ({ appId, platform, country, lang }) => { try { let appDetails; if (platform === "android") { // Get app details from Google Play Store appDetails = await memoizedGplay.app({ appId, country, lang }); // Normalize Android app details appDetails = { id: appDetails.appId, appId: appDetails.appId, title: appDetails.title, description: appDetails.description, summary: appDetails.summary, developer: appDetails.developer, developerId: appDetails.developerId, developerEmail: appDetails.developerEmail, developerWebsite: appDetails.developerWebsite, icon: appDetails.icon, headerImage: appDetails.headerImage, screenshots: appDetails.screenshots, score: appDetails.score, scoreText: appDetails.scoreText, ratings: appDetails.ratings, reviews: appDetails.reviews, histogram: appDetails.histogram, price: appDetails.price, free: appDetails.free, currency: appDetails.currency, categories: appDetails.categories, genre: appDetails.genre, genreId: appDetails.genreId, contentRating: appDetails.contentRating, released: appDetails.released, updated: appDetails.updated, version: appDetails.version, size: appDetails.size, recentChanges: appDetails.recentChanges, platform: "android" }; } else { // Get app details from Apple App Store // For iOS, we need to handle both numeric IDs and bundle IDs const isNumericId = /^\d+$/.test(appId); const lookupParams = isNumericId ? { id: appId, country, lang } : { appId: appId, country, lang }; appDetails = await memoizedAppStore.app({ ...lookupParams, ratings: true // Get ratings information too }); // Normalize iOS app details appDetails = { id: appDetails.id.toString(), appId: appDetails.appId, title: appDetails.title, description: appDetails.description, summary: appDetails.description?.substring(0, 100), developer: appDetails.developer, developerId: appDetails.developerId, developerWebsite: appDetails.developerWebsite, icon: appDetails.icon, screenshots: appDetails.screenshots, ipadScreenshots: appDetails.ipadScreenshots, score: appDetails.score, scoreText: appDetails.score?.toString(), ratings: appDetails.ratings, reviews: appDetails.reviews, histogram: appDetails.histogram, price: appDetails.price, free: appDetails.free, currency: appDetails.currency, genres: appDetails.genres, primaryGenre: appDetails.primaryGenre, contentRating: appDetails.contentRating, released: appDetails.released, updated: appDetails.updated, version: appDetails.version, size: appDetails.size, releaseNotes: appDetails.releaseNotes, platform: "ios" }; } return { content: [{ type: "text", text: JSON.stringify({ appId, platform, details: appDetails }, null, 2) }] }; } catch (error) { return { content: [{ type: "text", text: JSON.stringify({ error: error.message, appId, platform }, null, 2) }], isError: true }; } } );