Store Scraper MCP

Store Scraper MCP is a self-contained MCP server that lets you query App Store and Google Play Store data through a unified set of tools. It focuses on providing structured access to app details, reviews, ratings, rankings, and related data across iOS and Android stores, all via MCP endpoints.

How to use

You connect to this MCP server using your MCP client and call the available tools to retrieve data from the App Store and Google Play Store. Use the dedicated tool names for each data type, such as app, search, list, reviews, and more, for both iOS and Android data sources. Responses are normalized JSON, with robust error handling and automatic retries to improve reliability.

Typical usage patterns include getting detailed app information, searching apps by term, retrieving top app rankings, and fetching reviews or ratings distributions. For example, you can request an app’s details by specifying identifiers like the iOS bundleId or the Android appId, or perform a search to find apps that match a term. You can also fetch reviews with pagination to navigate through user feedback. Use the same approach for Google Play with each corresponding gp_ tool set.

How to install

Prerequisites you need installed on your system are Node.js version 18 or newer and a package manager such as npm or yarn.

1. Prepare the project directory where the MCP server will run. Ensure you have the project checked out at the path you will reference in the commands.

2. Install dependencies for the MCP server. Run the following in your project root:

npm install

3. Start the MCP server using the explicit runtime command shown in the configuration. Replace the absolute path with your actual project path:

node /absolute/path/to/store-scraper-mcp/src/server.js

4. After configuring an MCP client like Cursor, restart your Cursor client to pick up the new MCP server configuration.

Configuration

Configure your MCP client to connect to the local MCP server by specifying the stdio entry shown below. This uses Node to run the server script directly and keeps the server self-contained in your project.

{
  "mcpServers": {
    "store-scraper": {
      "command": "node",
      "args": ["/absolute/path/to/store-scraper-mcp/src/server.js"],
      "cwd": "/absolute/path/to/store-scraper-mcp"
    }
  }
}

Replace /absolute/path/to/store-scraper-mcp with your actual project path. Restart Cursor completely after configuration.

## Notes and tips

This server provides 20 MCP tools split across App Store (iOS) and Google Play (Android). The App Store tools include app, search, list, reviews, ratings, developer, similar, privacy, versionHistory, and suggest. The Google Play tools include gp\_app, gp\_search, gp\_list, gp\_reviews, gp\_developer, gp\_similar, gp\_permissions, gp\_datasafety, gp\_categories, and gp\_suggest.

If a requested data point is unavailable or parsing fails, the server returns null for the object, an empty array for lists, and descriptive error messages to help you troubleshoot.

## Security and reliability

The server includes automatic retries with exponential backoff and timeout handling to improve resilience when data cannot be fetched on the first attempt.

All communications and data handling follow standard MCP patterns, and responses are structured JSON for easy consumption by your applications.

## Available tools

### app

Get detailed information about an iOS app using its bundle ID or iTunes trackId, returning metadata like name, developer, category, and more.

### search

Search for apps in the App Store by a search term, with optional country, language, result count, and pagination.

### list

Get App Store rankings such as top free, top paid, and top grossing apps for a given country and optional genre.

### reviews

Retrieve app reviews with support for pagination to navigate through user feedback.

### ratings

Fetch the ratings distribution for an App Store app, including average rating and counts.

### developer

Get all apps published by a specific developer.

### similar

Find apps similar to a given app to help with discovery and comparison.

### privacy

Return privacy labels and data usage information for an App Store app.

### versionHistory

Obtain the version history for an App Store app, including release dates and changes.

### suggest

Provide search suggestions and autocomplete results for App Store queries.

### gp\_app

Get detailed information about an Android app using its appId, with optional language and country selections.

### gp\_search

Search for apps on Google Play by term, with optional country and language and configurable result count.

### gp\_list

Get app rankings from Google Play for a given country and optional category/genre.

### gp\_reviews

Retrieve Google Play reviews with pagination support.

### gp\_developer

Get all apps published by a Google Play developer.

### gp\_similar

Find apps similar to a given Google Play app.

### gp\_permissions

Fetch the permissions requested by a Google Play app.

### gp\_datasafety

Obtain data safety information for a Google Play app.

### gp\_categories

List available Google Play app categories.

### gp\_suggest

Provide search suggestions and autocomplete results for Google Play queries.