ASO MCP Server
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., "@ASO MCP Server suggest keywords for meditation"
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.
ASO MCP Server
A Model Context Protocol (MCP) server for App Store Optimization (ASO) research in Google Play Store.
Please note: This MCP is a very early feature-limited prototype and is not yet ready for production use.
Built on top of google-play-scraper - a Python library for scraping Google Play Store data.
Features
App Search - Search for apps by keyword with price filtering
App Details - Get comprehensive information about any app
App Reviews - Fetch user reviews with sorting, filtering, and pagination
Collections & Categories - Browse top free, top paid, and grossing apps by category
Keywords Research - Get keyword suggestions from Google Play Store autocomplete
Metadata Validation - Validate titles, short descriptions, and full descriptions against Google Play limits
Country & Language Support - Access all Google Play supported countries and languages
Proxy Rotation - Optional proxy support with automatic rotation and retry on failure
Related MCP server: play-console-mcp
Installation
Prerequisites
Python 3.14+
uv (recommended) or pip
Setup
# Clone the repository
git clone <repository-url>
cd aso-mcp-python
# Install dependencies with uv
uv sync
# Or with pip
pip install -e .
# Install development dependencies (for testing)
uv sync --dev
# Or with pip
pip install -e ".[dev]"Usage
Running the Server
uv run python server.pyIntegration with AI Assistants
Claude Code
Add to ~/.claude/settings.json:
{
"mcpServers": {
"aso": {
"command": "uv",
"args": [
"run",
"python",
"server.py"
],
"cwd": "/path/to/aso-mcp-python"
}
}
}Gemini CLI
Add to ~/.gemini/settings.json:
{
"mcpServers": {
"aso": {
"command": "uv",
"args": [
"run",
"python",
"server.py"
],
"cwd": "/path/to/aso-mcp-python"
}
}
}Available Tools
App Search & Discovery
google-play-search
Search for apps in Google Play Store by keyword.
Parameters:
country(string) - Country code (e.g.,us,de,jp)language(string) - Language code (e.g.,en,de,ja)term(string) - Search termnum(integer, optional) - Number of results (default: 20)price(string, optional) - Price filter: "all", "free", or "paid" (default: "all")
Returns: List of app overviews with basic info (title, developer, score, etc.)
google-play-list
Browse Google Play Store collections and categories.
Parameters:
country(string) - Country codelanguage(string) - Language codecollection(string) - Collection type: "TOP_FREE", "TOP_PAID", or "GROSSING"category(string) - Category (e.g., "APPLICATION", "GAME_ACTION", "PRODUCTIVITY")num(integer, optional) - Number of results (default: 50)age(string, optional) - Age filter: "AGE_RANGE1" (5 and under), "AGE_RANGE2" (6-8), or "AGE_RANGE3" (9+)
Available Categories:
General:
APPLICATION,GAME,FAMILYApp Categories:
BUSINESS,EDUCATION,ENTERTAINMENT,FINANCE,HEALTH_AND_FITNESS,PRODUCTIVITY,TOOLS, and moreGame Categories:
GAME_ACTION,GAME_ADVENTURE,GAME_PUZZLE,GAME_RACING,GAME_STRATEGY, and more
Returns: List of app overviews
google-play-app
Get comprehensive details about a specific app.
Parameters:
country(string) - Country codelanguage(string) - Language codeapp_id(string) - App package ID (e.g., "com.spotify.music")
Returns: Detailed app information including:
Basic info (title, developer, summary, descriptions)
Ratings (score, reviews count, histogram)
Pricing (price, currency, in-app purchases)
Install statistics (installs, min/max installs)
Media (icon, screenshots, video, header image)
Technical details (version, Android version, release/update dates)
Contact info (email, website, address)
Legal (content rating, privacy policy)
google-play-reviews
Get user reviews for a specific app with pagination support.
Parameters:
country(string) - Country codelanguage(string) - Language codeapp_id(string) - App package IDsort(string, optional) - Sort order: "newest", "rating", or "helpfulness" (default: "newest")num(integer, optional) - Number of reviews (default: 100)filter_rating(integer, optional) - Filter by rating (1-5)continuation_token(string, optional) - Token for fetching next page
Returns: Reviews with user info, rating, text, developer reply (if any), and pagination token for next page
Keywords Research
google-play-suggest
Get keyword suggestions for a given seed keyword.
Parameters:
country(string) - Country code (e.g.,us,de,jp)language(string) - Language code (e.g.,en,de,ja)keyword(string) - Seed keyword or partial keyword
Example:
country: "us"
language: "en"
keyword: "calc"Returns: List of suggested keywords like ["calculator", "calculator app", "calculator free", ...]
Metadata Validation
google-play-validate-title
Validate a title against Google Play's 30 character limit.
Parameters:
title(string) - Title to validate
google-play-validate-short-description
Validate a short description against Google Play's 80 character limit.
Parameters:
short_description(string) - Short description to validate
google-play-validate-full-description
Validate a full description against Google Play's 4000 character limit.
Parameters:
full_description(string) - Full description to validate
Returns: Validation result with length, validity status, and any errors.
Reference Data
get-google-play-languages
Get all language codes supported by Google Play.
get-google-play-countries
Get all country codes supported by Google Play.
get-google-play-countries-with-languages
Get country codes mapped to their supported languages.
Proxy Configuration
The server supports optional proxy rotation for requests to Google Play. This is useful for:
Avoiding rate limiting
Geographic distribution of requests
IP rotation
Setup
Set the ASO_MCP_PROXIES environment variable with a comma-separated list of proxy URLs:
export ASO_MCP_PROXIES="http://proxy1:8080,http://proxy2:8080,http://user:pass@proxy3:8080"With Claude Code
{
"mcpServers": {
"aso": {
"command": "uv",
"args": [
"run",
"python",
"server.py"
],
"cwd": "/path/to/aso-mcp-python",
"env": {
"ASO_MCP_PROXIES": "http://proxy1:8080,http://proxy2:8080"
}
}
}
}With Gemini CLI
{
"mcpServers": {
"aso": {
"command": "uv",
"args": [
"run",
"python",
"server.py"
],
"cwd": "/path/to/aso-mcp-python",
"env": {
"ASO_MCP_PROXIES": "http://proxy1:8080,http://proxy2:8080"
}
}
}
}How Proxy Rotation Works
On each request, a random proxy is selected from the pool
If a request fails, the proxy is marked as failed and a different proxy is tried
Failed proxies are avoided until all proxies have failed
When all proxies fail, the failed list resets and rotation starts over
Credentials in proxy URLs are masked in logs for security
Supported Proxy Formats
http://host:port
http://username:password@host:port
https://host:port
https://username:password@host:portGoogle Play Metadata Limits
Field | Character Limit |
Title | 30 |
Short Description | 80 |
Full Description | 4000 |
Supported Countries
The server supports 60+ countries including:
Region | Countries |
Americas | US, CA, BR, MX |
Europe | GB, DE, FR, ES, IT, NL, PL, and more |
Asia Pacific | JP, KR, CN, IN, AU, SG, and more |
Middle East | SA, IL, TR, and more |
Use get-google-play-countries-with-languages to get the full mapping of countries to their supported languages.
Development
Project Structure
aso-mcp-python/
├── server.py # Main MCP server
├── proxy.py # Proxy rotation manager
├── constants/
│ ├── google_play_constants.py # Countries, languages, limits, enums
│ └── mcp_constants.py # Server instructions
├── models/
│ ├── google_play.py # Data models (AppDetails, AppOverview, Review)
│ └── metadata.py # Validation models
├── tests/
│ └── test_server.py # Comprehensive test suite
├── pyproject.toml # Project configuration
├── pytest.ini # Pytest configuration
└── README.mdDependencies
mcp[cli]- Model Context Protocol SDKplay-store-scraper-ng- Google Play Store scraperhttpx- HTTP client
Development Dependencies
pytest- Testing frameworkpytest-asyncio- Async test supportpytest-mock- Mocking support
Running Tests
# Run all tests
uv run pytest
# Run with coverage
uv run pytest --cov=. --cov-report=html
# Run specific test file
uv run pytest tests/test_server.py
# Run specific test
uv run pytest tests/test_server.py::TestSearch::test_google_play_search_success
# Run with verbose output
uv run pytest -vThe test suite includes:
Unit tests for all tools
Mock-based tests (no actual API calls)
Proxy rotation and failure scenarios
Input validation tests
Pagination tests for reviews
License
MIT
Available Tools
16 toolsget-google-play-age-filtersA
Get list of age filters for browsing (FIVE_UNDER, SIX_EIGHT, NINE_UP)
Inputs: no named parameters. Returns: result
get-google-play-categoriesA
Get list of app categories in Google Play Store
Inputs: no named parameters. Returns: result
get-google-play-collectionsA
Get list of collection types for browsing Google Play Store (TOP_FREE, TOP_PAID, GROSSING)
Inputs: no named parameters. Returns: result
get-google-play-countriesA
Get list of country codes supported by Google Play
Inputs: no named parameters. Returns: result
get-google-play-countries-with-languagesA
Get list of country codes mapped with a list of languages in these countries supported by Google Play
Inputs: no named parameters. Returns: result
get-google-play-languagesA
Get list of language codes supported by Google Play
Inputs: no named parameters. Returns: result
get-google-play-rating-filtersA
Get list of valid rating filters for reviews (1-5)
Inputs: no named parameters. Returns: result
get-google-play-sort-ordersA
Get list of sort orders for reviews (NEWEST, RATING, HELPFULNESS)
Inputs: no named parameters. Returns: result
google-play-appC
Get detailed information about a specific app
Inputs: app_id (required), country (required), language (required). Returns: Detailed app information.
google-play-listC
Browse Google Play Store collections (top free, top paid, grossing) by category
Inputs: country (required), category (required), language (required), collection (required), +2 more. Returns: result
google-play-reviewsC
Get user reviews for a specific app with pagination support
Inputs: app_id (required), country (required), language (required), num, +3 more. Returns: Response from reviews endpoint including pagination token
google-play-searchD
Search for apps in Google Play Store
Inputs: term (required), country (required), language (required), num, +1 more. Returns: result
google-play-suggestC
Get keywords suggestions for the given keyword in Google Play Store
Inputs: country (required), keyword (required), language (required). Returns: result
google-play-validate-full-descriptionC
Validate full description for Google Play Store
Inputs: full_description (required). Returns: errors, length, is_valid
google-play-validate-short-descriptionD
Validate short description for Google Play Store
Inputs: short_description (required). Returns: errors, length, is_valid
google-play-validate-titleC
Validate title for Google Play Store
Inputs: title (required). Returns: errors, length, is_valid
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 16 tools
All tools have distinct purposes: retrieving metadata options (age filters, ratings, languages, etc.), search, listing collections, app details, reviews, suggestions, and validation. No two tools overlap in functionality.
Naming follows a consistent pattern: 'get-google-play-*' for metadata retrieval and 'google-play-*' for actions (search, list, app, reviews, suggest, validate). All lowercase with hyphens, making it predictable.
With 16 tools, it is slightly above the typical 3-15 range but still well-scoped. Each tool serves a necessary function for ASO tasks, and the count does not feel excessive.
The tool set covers all essential ASO operations: searching, browsing, app details, reviews, suggestions, metadata options, and validation of titles and descriptions. No obvious gaps for querying Google Play data.
Related MCP Connectors
App Store and Google Play ASO: keyword rankings, competitors, reviews, audits and an action queue.
ASO for App Store and Google Play: keyword research, rank tracking, in-app feedback and analytics.
App Store and Google Play keyword ranks, keyword research and competitors for your apps.
App intelligence across Google Play and the App Store: details, reviews, and search in one API.
Related MCP Servers
- AlicenseCqualityDmaintenanceEnables querying and retrieving data from App Store and Google Play Store, including app details, reviews, ratings, rankings, permissions, and search capabilities across both iOS and Android platforms.20MIT
- AlicenseAqualityBmaintenanceEnables AI agents to manage Google Play Console reviews and Android app releases, including replying to reviews, promoting releases, managing staged rollouts, and checking crash/ANR vitals.34276 npm2MIT
- AlicenseBqualityBmaintenanceStorelift's MCP server lets Claude, ChatGPT, Cursor or any MCP client read your App Store and Google Play keyword ranks, rivals, reviews, store pages, charts and AI visibility. Included on Pro and Studio (Pro: 5 apps, 1,000 keywords, 175 storefronts); the Free plan (1 app, 10 keywords in 2 storefronts) does not include MCP or the API.8580 npm1MIT
- AlicenseNot gradedqualityBmaintenanceEnables retrieval of App Store and Google Play reviews, ratings summaries, and ASO keyword rankings for any app using its store ID or package name.58 npmMIT