mcp-appstore-reviews
This server manages Apple App Store customer reviews and developer responses — and nothing else.
List customer reviews (
list_reviews): Retrieve reviews for a given app (by numeric App Store ID). Each review includes its ID, star rating, title, body, reviewer nickname, territory, date, and any existing developer response ID. Supports filtering by:Territory (e.g.
USA,GBR)Exact star rating (1–5)
Sort order:
recent(default),favorable(highest rated first), orcritical(lowest rated first)Result limit (1–200, default 50)
Publish a developer response (
respond_to_review): Post a public developer reply to a specific customer review using its review ID. Only one response per review is allowed — an existing response must be deleted before a new one can be posted.Delete a developer response (
delete_review_response): Remove an existing developer response using the response ID (obtained fromlist_reviews), not the review ID itself.
Allows reading customer reviews and managing developer responses for apps on the Apple App Store.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mcp-appstore-reviews list reviews for app ID 123456789"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
mcp-appstore-reviews
A small, reviews-only MCP server for the Apple App Store, backed by the App Store Connect API. It lets an agent read customer reviews and publish or delete developer responses — and deliberately nothing else.
Why so narrow?
The capability boundary is the trust guarantee. This server exposes only the three review tools below. There is intentionally no build, release, submission, pricing, in-app-purchase, certificate, profile, or beta-tester tool, so the App Store Connect key you give it can't be used to do any of those things. Scope the key itself narrowly too (the Customer Support role is enough).
It is also dependency-free — pure Node 18+ (fetch + built-in crypto),
no third-party packages — so there is no supply chain to audit beyond this one
file (index.mjs).
Related MCP server: io.github.gjeltep/app-store-connect-mcp
Tools
Tool | Description |
| List reviews for an app (newest first by default), including any existing developer response and its id. Filters: |
| Publish a developer response to a review ( |
| Delete a developer response by its |
Authentication
Create an App Store Connect API key (Users and Access → Integrations → App Store Connect API). Two kinds of key work:
Team key — needs the Customer Support role (enough to manage reviews without Admin's broader powers), but only an Admin can generate it. Supply the Issuer ID along with the Key ID and
.p8.Individual key — any user can generate their own (no Admin needed) and it inherits that user's permissions. It has no Issuer ID: leave
APP_STORE_CONNECT_ISSUER_IDunset and supply just the Key ID and.p8.
Then provide:
Env var | What |
| Issuer ID shown at the top of the Integrations page — team keys only; omit for individual keys |
| Key ID of the API key |
| Path to the downloaded |
The private key is read only to sign a short-lived ES256 JWT for Apple; it is never logged, copied, or sent anywhere but Apple's API.
Run
# stdio MCP server
APP_STORE_CONNECT_ISSUER_ID=... \
APP_STORE_CONNECT_KEY_ID=... \
APP_STORE_CONNECT_PRIVATE_KEY_PATH=/path/to/AuthKey_XXXX.p8 \
npx -y github:ForgeHQ-Agents/mcp-appstore-reviewsThe agent passes the app's numeric App Store ID as appId (find it in App Store
Connect → your app → App Information, or in the app's App Store URL).
Test
npm test # node --test, zero dependenciesLicense
MIT
Available Tools
3 toolsdelete_review_responseA
Delete an existing developer response. Takes the response id (the response.id field surfaced by list_reviews), not the review id.
Inputs: responseId (required).
list_reviewsA
List customer reviews for an app, newest first by default. Each review includes its id, star rating, title, body, reviewer nickname, territory, date, and the existing developer response (with its id) if one exists. Use the response id with delete_review_response.
Inputs: appId (required), territory, rating, sort, +1 more.
respond_to_reviewA
Publish a public developer response to a customer review. One response per review — if the review already has a response, delete it first with delete_review_response, then respond again.
Inputs: reviewId (required), responseBody (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
Each tool has a clear, distinct purpose: listing reviews, responding to a review, and deleting a response. No overlap or ambiguity.
All tool names follow a consistent verb_noun pattern in snake_case (list_reviews, respond_to_review, delete_review_response).
Three tools cover the essential operations for app store review responses: list, respond, and delete. The count is well-scoped for this domain.
Covers the full lifecycle of review responses (read, create, delete). Minor gap: no direct update for a response (requires delete+create), but the documentation clarifies the intended workflow.
Maintenance
Related MCP Connectors
App Store Connect operator for AI agents: icons, TestFlight builds, listings, IAP, rejection fixes.
Read, search, analyze and draft replies to App Store and Google Play reviews (OAuth sign-in).
Apple App Store reviews as structured JSON via the Apify Reviews API Actor, hosted MCP.
Read products, sales, subscribers and offer codes; verify, enable and disable product licenses.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables analysis and management of iOS/macOS apps via the App Store Connect API, including app management, reviews, sales reports, analytics, performance metrics, and TestFlight.14 npm2MIT
- AlicenseCqualityDmaintenanceEnables management of App Store Connect resources including app reviews, TestFlight crashes, analytics reports, and Xcode Cloud workflows through natural language or AI agents.401MIT
- AlicenseBqualityBmaintenanceEnables AI assistants to manage app listings, versions, localizations, screenshots, TestFlight groups and testers, bundle IDs, devices, users, analytics reports, and sales or finance reports through the App Store Connect API.3628 npmMIT
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to manage App Store Connect releases—versions, builds, TestFlight groups, metadata, pricing, reviews, and submission—while staying read-only by default and requiring human approval before any public or destructive action.2MIT