google-play-details
Retrieve comprehensive Google Play app data including ratings, installs, pricing, developer details, and version information for market analysis and competitor research.
Instructions
Get detailed information about a Google Play app. Returns an object with:
title: App name
description: Full app description
descriptionHTML: Description with HTML formatting
summary: Short description
installs: Install count range
minInstalls: Minimum install count
maxInstalls: Maximum install count
score: Average rating (0-5)
scoreText: Rating display text
ratings: Total number of ratings
reviews: Total number of reviews
histogram: Rating distribution by star level
price: Price in local currency
free: Boolean indicating if app is free
currency: Price currency code
priceText: Formatted price string
offersIAP: Boolean indicating in-app purchases
IAPRange: Price range for in-app purchases
androidVersion: Minimum Android version required
androidVersionText: Formatted Android version text
developer: Developer name
developerId: Developer ID
developerEmail: Developer contact email
developerWebsite: Developer website URL
developerAddress: Developer physical address
genre: App category
genreId: Category ID
icon: Icon URL
headerImage: Feature graphic URL
screenshots: Array of screenshot URLs
contentRating: Content rating (e.g. 'Everyone')
contentRatingDescription: Content rating details
adSupported: Boolean indicating if app shows ads
released: Release date
updated: Last update date
version: Current version string
recentChanges: Latest version changes
preregister: Boolean indicating if app is in pre-registration
editorsChoice: Boolean indicating Editor's Choice status
features: Array of special features
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| appId | Yes | Google Play package name (e.g., 'com.google.android.apps.translate') | |
| lang | No | Language code for result text (default: en) | en |
| country | No | Country code to check app availability (default: us) | us |
Implementation Reference
- src/server.js:473-476 (handler)Handler function that executes the tool logic: fetches Google Play app details using the gplay library and returns the JSON-stringified result wrapped in MCP content format.async ({ appId, lang, country }) => { const details = await gplay.app({ appId, lang, country }); return { content: [{ type: "text", text: JSON.stringify(details) }] }; }
- src/server.js:468-472 (schema)Zod schema for input validation, defining parameters appId (required string), lang and country (optional strings with defaults).{ appId: z.string().describe("Google Play package name (e.g., 'com.google.android.apps.translate')"), lang: z.string().default("en").describe("Language code for result text (default: en)"), country: z.string().default("us").describe("Country code to check app availability (default: us)") },
- src/server.js:426-477 (registration)Registration of the 'google-play-details' tool with server.tool, providing the tool name, detailed description string, input schema, and handler function.server.tool("google-play-details", "Get detailed information about a Google Play app. Returns an object with:\n" + "- title: App name\n" + "- description: Full app description\n" + "- descriptionHTML: Description with HTML formatting\n" + "- summary: Short description\n" + "- installs: Install count range\n" + "- minInstalls: Minimum install count\n" + "- maxInstalls: Maximum install count\n" + "- score: Average rating (0-5)\n" + "- scoreText: Rating display text\n" + "- ratings: Total number of ratings\n" + "- reviews: Total number of reviews\n" + "- histogram: Rating distribution by star level\n" + "- price: Price in local currency\n" + "- free: Boolean indicating if app is free\n" + "- currency: Price currency code\n" + "- priceText: Formatted price string\n" + "- offersIAP: Boolean indicating in-app purchases\n" + "- IAPRange: Price range for in-app purchases\n" + "- androidVersion: Minimum Android version required\n" + "- androidVersionText: Formatted Android version text\n" + "- developer: Developer name\n" + "- developerId: Developer ID\n" + "- developerEmail: Developer contact email\n" + "- developerWebsite: Developer website URL\n" + "- developerAddress: Developer physical address\n" + "- genre: App category\n" + "- genreId: Category ID\n" + "- icon: Icon URL\n" + "- headerImage: Feature graphic URL\n" + "- screenshots: Array of screenshot URLs\n" + "- contentRating: Content rating (e.g. 'Everyone')\n" + "- contentRatingDescription: Content rating details\n" + "- adSupported: Boolean indicating if app shows ads\n" + "- released: Release date\n" + "- updated: Last update date\n" + "- version: Current version string\n" + "- recentChanges: Latest version changes\n" + "- preregister: Boolean indicating if app is in pre-registration\n" + "- editorsChoice: Boolean indicating Editor's Choice status\n" + "- features: Array of special features", { appId: z.string().describe("Google Play package name (e.g., 'com.google.android.apps.translate')"), lang: z.string().default("en").describe("Language code for result text (default: en)"), country: z.string().default("us").describe("Country code to check app availability (default: us)") }, async ({ appId, lang, country }) => { const details = await gplay.app({ appId, lang, country }); return { content: [{ type: "text", text: JSON.stringify(details) }] }; } );