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

NameTypeRequiredDescription
app_idstringyesNumeric App Store app id, e.g. “389801252” (Instagram)
countrystringnoTwo-letter storefront country code (default “us”)
sortstringnoOrder (default “recent”)
pagenumbernoPage 1-10, 50 reviews each (default 1)
limitnumbernoMax 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

FieldTypeDescription
app_idstring
countrystring
sortstring
pagenumber
countnumber
reviewsarray
sourcestring
notestring
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.

Regenerated from source · build November 21, 2026