get_app_details
Retrieve detailed app information from Apple App Store or Google Play Store by providing the app ID and platform. Use this tool to access metadata like descriptions, ratings, and availability for specific apps.
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'). | |
| platform | Yes | The platform of the app ('ios' or 'android'). | |
| 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 |
Implementation Reference
- server.js:154-269 (handler)Handler function that implements the get_app_details tool. Fetches detailed app information from Google Play Store (using google-play-scraper) or Apple App Store (using app-store-scraper) based on the platform. Normalizes the response data and returns it as JSON text content. Handles both numeric IDs and bundle IDs for iOS.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)Zod input schema for the get_app_details tool defining parameters: appId (required), platform (required), country (optional, default 'us'), lang (optional, 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)Registration of the 'get_app_details' tool on the MCP server using server.tool(name, inputSchema, handlerFn).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 }; } } );