get_similar_apps
Find similar apps on iOS or Android by entering an app ID, platform, and optional parameters like country, language, and result count. Ideal for competitive analysis or app discovery.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| appId | Yes | The unique identifier for the app (Android package name, iOS numeric ID or bundle ID). | |
| country | No | Two-letter country code for the App Store/Play Store region. Default 'us'. | us |
| lang | No | Language code for the results. Default 'en'. | en |
| num | No | Number of similar apps to return (default 20). | |
| platform | Yes | The platform of the app ('ios' or 'android'). |
Implementation Reference
- server.js:1512-1614 (handler)The complete handler function for the 'get_similar_apps' tool, registered via server.tool(). It validates input with Zod schema and fetches similar apps using memoized gplay.similar() for Android and appStore.similar() for iOS, standardizing the output format.server.tool( "get_similar_apps", { appId: z.string().describe("The unique identifier for the app (Android package name, iOS numeric ID or bundle ID)."), 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 the App Store/Play Store region. Default 'us'."), lang: z.string().optional().default("en").describe("Language code for the results. Default 'en'."), num: z.number().optional().default(20).describe("Number of similar apps to return (default 20).") }, async ({ appId, platform, country, lang, num }) => { try { let similarApps = []; if (platform === "android") { // Get similar apps from Google Play Store const apps = await memoizedGplay.similar({ appId, country, lang }); // Limit results to num similarApps = apps.slice(0, num).map(app => ({ id: app.appId, appId: app.appId, title: app.title, summary: app.summary || "", developer: app.developer, developerId: app.developerId, icon: app.icon, score: app.score, scoreText: app.scoreText, price: app.price, free: app.free, currency: app.currency || "USD", platform: "android", url: app.url })); } else { // For iOS, we need to check if appId is a numeric ID or bundle ID const isNumericId = /^\d+$/.test(appId); // Get similar apps from Apple App Store let iosParams = {}; if (isNumericId) { iosParams = { id: appId, country }; } else { iosParams = { appId, country }; } const apps = await memoizedAppStore.similar(iosParams); // Limit results to num similarApps = apps.slice(0, num).map(app => ({ id: app.id.toString(), appId: app.appId, title: app.title, summary: app.description || "", developer: app.developer, developerId: app.developerId, icon: app.icon, score: app.score, price: app.price, free: app.free === true, currency: app.currency, platform: "ios", url: app.url })); } return { content: [{ type: "text", text: JSON.stringify({ appId, platform, count: similarApps.length, similarApps }, null, 2) }] }; } catch (error) { return { content: [{ type: "text", text: JSON.stringify({ error: error.message, appId, platform }, null, 2) }], isError: true }; } } );
- server.js:1514-1520 (schema)Zod input schema for the get_similar_apps tool defining parameters: appId (required), platform (ios/android), optional country, lang, num.{ appId: z.string().describe("The unique identifier for the app (Android package name, iOS numeric ID or bundle ID)."), 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 the App Store/Play Store region. Default 'us'."), lang: z.string().optional().default("en").describe("Language code for the results. Default 'en'."), num: z.number().optional().default(20).describe("Number of similar apps to return (default 20).") },
- server.js:1512-1614 (registration)Registration of the get_similar_apps tool using McpServer.tool() method.server.tool( "get_similar_apps", { appId: z.string().describe("The unique identifier for the app (Android package name, iOS numeric ID or bundle ID)."), 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 the App Store/Play Store region. Default 'us'."), lang: z.string().optional().default("en").describe("Language code for the results. Default 'en'."), num: z.number().optional().default(20).describe("Number of similar apps to return (default 20).") }, async ({ appId, platform, country, lang, num }) => { try { let similarApps = []; if (platform === "android") { // Get similar apps from Google Play Store const apps = await memoizedGplay.similar({ appId, country, lang }); // Limit results to num similarApps = apps.slice(0, num).map(app => ({ id: app.appId, appId: app.appId, title: app.title, summary: app.summary || "", developer: app.developer, developerId: app.developerId, icon: app.icon, score: app.score, scoreText: app.scoreText, price: app.price, free: app.free, currency: app.currency || "USD", platform: "android", url: app.url })); } else { // For iOS, we need to check if appId is a numeric ID or bundle ID const isNumericId = /^\d+$/.test(appId); // Get similar apps from Apple App Store let iosParams = {}; if (isNumericId) { iosParams = { id: appId, country }; } else { iosParams = { appId, country }; } const apps = await memoizedAppStore.similar(iosParams); // Limit results to num similarApps = apps.slice(0, num).map(app => ({ id: app.id.toString(), appId: app.appId, title: app.title, summary: app.description || "", developer: app.developer, developerId: app.developerId, icon: app.icon, score: app.score, price: app.price, free: app.free === true, currency: app.currency, platform: "ios", url: app.url })); } return { content: [{ type: "text", text: JSON.stringify({ appId, platform, count: similarApps.length, similarApps }, null, 2) }] }; } catch (error) { return { content: [{ type: "text", text: JSON.stringify({ error: error.message, appId, platform }, null, 2) }], isError: true }; } } );