reviews
Retrieve app reviews from app stores with pagination and sorting options to analyze user feedback.
Instructions
Get app reviews with pagination
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | iTunes trackId of the app | |
| appId | No | Bundle ID of the app | |
| country | No | Two-letter country code (default: us) | us |
| page | No | Page number (1-10, default: 1) | |
| sort | No | Sort order: mostRecent or mostHelpful | mostRecent |
Implementation Reference
- src/server.js:210-254 (handler)The main handler function for the 'reviews' MCP tool. Builds the reviews URL using buildReviewsUrl, fetches JSON data, parses it with parseReviews, and returns the paginated reviews in JSON format./** * Reviews tool - Get app reviews with pagination */ async function handleReviews(args) { try { const { id, appId, country = 'us', page = 1, sort = 'mostRecent', } = args; if (!id && !appId) { throw new Error('Either id or appId must be provided'); } const url = buildReviewsUrl({ id, appId, country, page, sort }); const data = await fetchJSON(url); const reviews = parseReviews(data); return { content: [ { type: 'text', text: JSON.stringify({ page, reviews, count: reviews.length, }, null, 2), }, ], }; } catch (error) { return { content: [ { type: 'text', text: JSON.stringify({ error: error.message }, null, 2), }, ], isError: true, }; } }
- src/server.js:1028-1059 (schema)Input schema definition for the 'reviews' tool, including parameters like id/appId, country, page, and sort order.name: 'reviews', description: 'Get app reviews with pagination', inputSchema: { type: 'object', properties: { id: { type: 'number', description: 'iTunes trackId of the app', }, appId: { type: 'string', description: 'Bundle ID of the app', }, country: { type: 'string', description: 'Two-letter country code (default: us)', default: 'us', }, page: { type: 'number', description: 'Page number (1-10, default: 1)', default: 1, }, sort: { type: 'string', description: 'Sort order: mostRecent or mostHelpful', default: 'mostRecent', enum: ['mostRecent', 'mostHelpful'], }, }, }, },
- src/server.js:1451-1452 (registration)Registration of the 'reviews' tool handler in the CallToolRequestSchema switch statement.case 'reviews': return await handleReviews(args);
- Helper function that parses the raw iTunes RSS feed JSON into an array of structured review objects.export function parseReviews(data) { if (!data || !data.feed || !data.feed.entry) { return []; } // First entry is app metadata, skip it const reviews = Array.isArray(data.feed.entry) ? data.feed.entry.slice(1) : []; return reviews.map(entry => { const author = entry.author?.[0] || entry.author || {}; const rating = entry['im:rating']?.label || entry['im:rating'] || '0'; const version = entry['im:version']?.label || entry['im:version'] || null; const title = entry.title?.label || entry.title || null; const content = entry.content?.label || entry.content?.[0]?.label || entry.content || null; const updated = entry.updated?.label || entry.updated || null; const id = entry.id?.label || entry.id || null; // Extract user ID from author URI if available let userId = null; let userUrl = null; if (author.uri?.label || author.uri) { const uri = author.uri.label || author.uri; const match = uri.match(/\/id(\d+)/); if (match) { userId = match[1]; userUrl = uri; } } return { id: id || null, userName: author.name?.label || author.name || 'Anonymous', userUrl: userUrl || null, version: version, score: parseInt(rating, 10) || 0, title: title, text: content, updated: updated, url: entry.link?.[0]?.attributes?.href || entry.link?.attributes?.href || null, }; }); }
- src/endpoints/appStore.js:79-91 (helper)Helper function that constructs the iTunes RSS URL for fetching customer reviews based on app ID, country, page, and sort order.export function buildReviewsUrl(params) { const { id, appId, country = 'us', page = 1, sort = 'mostRecent' } = params; if (!id && !appId) { throw new Error('Either id or appId must be provided'); } const appIdParam = id || appId; const pageNum = Math.min(page, 10); // Max 10 pages const sortParam = sort === 'mostHelpful' ? 'mostHelpful' : 'mostRecent'; return `${ITUNES_BASE}/${country}/rss/customerreviews/page=${pageNum}/id=${appIdParam}/sortby=${sortParam}/json`; }