appstore_reviews
Pack: app-reviews · Connect: https://pipeworx.io/mcp (see Connect below for a single-pack URL)
No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/appstore_reviews for the schema, then POST the same URL with its arguments for the data.
Recent customer reviews of an Apple App Store app in one country storefront, newest or most helpful first: rating (1-5), title, text, app version, date, and helpful votes. Reviewer names are not served. Source: Apple, App Store customer reviews. Pass the numeric app id (the number after “id” in an App Store URL); use itunes_search_search to find it. Up to 10 pages of 50.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
app_id | string | yes | Numeric App Store app id, e.g. “389801252” (Instagram) |
country | string | no | Two-letter storefront country code (default “us”) |
sort | string | no | Order (default “recent”) |
page | number | no | Page 1-10, 50 reviews each (default 1) |
limit | number | no | Max reviews to return, 1-50 (default 50) |
Example call
Arguments
{
"app_id": "389801252",
"country": "us",
"limit": 5
}
curl
curl -X POST https://gateway.pipeworx.io/app-reviews/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"appstore_reviews","arguments":{"app_id":"389801252","country":"us","limit":5}}}'
TypeScript (@pipeworx/sdk)
import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();
const result = await pipeworx.call('appstore_reviews', {
"app_id": "389801252",
"country": "us",
"limit": 5
});
Response shape
| Field | Type | Description |
|---|---|---|
app_id | string | |
country | string | |
sort | string | |
page | number | |
count | number | |
reviews | array | |
source | string | |
note | string |
Full JSON Schema
{
"type": "object",
"properties": {
"app_id": {
"type": "string"
},
"country": {
"type": "string"
},
"sort": {
"type": "string"
},
"page": {
"type": "number"
},
"count": {
"type": "number"
},
"reviews": {
"type": "array",
"items": {
"type": "object",
"properties": {
"review_id": {
"type": "string"
},
"rating": {
"type": "number"
},
"title": {
"type": "string"
},
"text": {
"type": "string"
},
"app_version": {
"type": "string"
},
"date": {
"type": "string"
},
"helpful_votes": {
"type": "number"
},
"vote_count": {
"type": "number"
}
},
"additionalProperties": true
}
},
"source": {
"type": "string"
},
"note": {
"type": "string"
}
},
"additionalProperties": true
}
Connect
Add this to your MCP client config — every tool in the catalog, including this one — or use one-click install buttons:
{
"mcpServers": {
"pipeworx": {
"url": "https://pipeworx.io/mcp"
}
}
}
Connect to just the app-reviews pack
{
"mcpServers": {
"app-reviews": {
"url": "https://gateway.pipeworx.io/app-reviews/mcp"
}
}
}
See Getting Started for client-specific install steps.