App Market Intelligence MCP

Instructions

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) }] };
    }
  );