App Market Intelligence MCP

Instructions

Implementation Reference

• src/server.js:507-533 (handler)

  The handler function that executes the tool logic: fetches Google Play app reviews using the gplay.reviews method with provided parameters, maps sort order, handles pagination, and returns a JSON-formatted response containing the reviews data and next page token.

  async ({ appId, lang, country, sort, num, paginate, nextPaginationToken }) => {
    const sortMap = {
      newest: gplay.sort.NEWEST,
      rating: gplay.sort.RATING,
      helpfulness: gplay.sort.HELPFULNESS
    };
  
    const reviews = await gplay.reviews({
      appId,
      lang,
      country,
      sort: sortMap[sort],
      num,
      paginate,
      nextPaginationToken
    });
  
    return {
      content: [{
        type: "text",
        text: JSON.stringify({
          reviews: reviews.data,
          nextPage: reviews.nextPaginationToken
        })
      }] 
    };
  }

• src/server.js:497-506 (schema)

  Zod schema defining the input parameters for the tool, including appId (required), lang, country, sort order, number of reviews, pagination flag, and pagination token.

  {
    appId: z.string().describe("Package name of the app (e.g., 'com.mojang.minecraftpe')"),
    lang: z.string().default("en").describe("Language code for reviews (default: en)"),
    country: z.string().default("us").describe("Country code (default: us)"),
    sort: z.enum(["newest", "rating", "helpfulness"]).default("newest")
      .describe("Sort order: newest, rating, or helpfulness (default: newest)"),
    num: z.number().default(100).describe("Number of reviews to retrieve (default: 100). Ignored if paginate is true."),
    paginate: z.boolean().default(false).describe("Enable pagination with 150 reviews per page"),
    nextPaginationToken: z.string().optional().describe("Token for fetching next page of reviews")
  }, 

• src/server.js:479-534 (registration)

  Registration of the 'google-play-reviews' tool via server.tool(), including the tool description, input schema, and inline handler function.

  server.tool("google-play-reviews", 
    "Get reviews for a Google Play app. Returns an array of reviews with:\n" +
    "- id: Review ID string\n" +
    "- userName: Reviewer's name\n" +
    "- userImage: Reviewer's profile image URL\n" +
    "- date: Review date (ISO string)\n" +
    "- score: Rating (1-5)\n" +
    "- scoreText: Rating display text\n" +
    "- title: Review title\n" +
    "- text: Review content\n" +
    "- url: Review URL\n" +
    "- version: App version reviewed\n" +
    "- thumbsUp: Number of thumbs up votes\n" +
    "- replyDate: Developer reply date (if any)\n" +
    "- replyText: Developer reply content (if any)\n" +
    "- criterias: Array of rating criteria (if any)\n" +
    "\nNote: Reviews are returned in the specified language. The total review count\n" +
    "shown in Google Play refers to ratings, not written reviews.",
    {
      appId: z.string().describe("Package name of the app (e.g., 'com.mojang.minecraftpe')"),
      lang: z.string().default("en").describe("Language code for reviews (default: en)"),
      country: z.string().default("us").describe("Country code (default: us)"),
      sort: z.enum(["newest", "rating", "helpfulness"]).default("newest")
        .describe("Sort order: newest, rating, or helpfulness (default: newest)"),
      num: z.number().default(100).describe("Number of reviews to retrieve (default: 100). Ignored if paginate is true."),
      paginate: z.boolean().default(false).describe("Enable pagination with 150 reviews per page"),
      nextPaginationToken: z.string().optional().describe("Token for fetching next page of reviews")
    }, 
    async ({ appId, lang, country, sort, num, paginate, nextPaginationToken }) => {
      const sortMap = {
        newest: gplay.sort.NEWEST,
        rating: gplay.sort.RATING,
        helpfulness: gplay.sort.HELPFULNESS
      };
  
      const reviews = await gplay.reviews({
        appId,
        lang,
        country,
        sort: sortMap[sort],
        num,
        paginate,
        nextPaginationToken
      });
  
      return {
        content: [{
          type: "text",
          text: JSON.stringify({
            reviews: reviews.data,
            nextPage: reviews.nextPaginationToken
          })
        }] 
      };
    }
  );