App Store MCP Server
This server provides read-only access to live Apple App Store data for competitor research, ASO, and product analysis — no Apple developer account or API keys required. Capabilities include:
Search apps (
search_app_store): Find apps by keyword, returning up to 50 slim results (ID, name, developer, rating, price).Get full app profile (
get_app_store_app): Fetch a complete public profile by numeric ID or App Store URL, including description, release notes, ratings, version history, screenshots, subtitle, in-app purchase flag, and privacy labels.Compare multiple apps (
compare_app_store_apps): Batch-fetch full profiles for several apps in a single call for side-by-side competitor comparison; individual failures don't break the batch.Get customer reviews (
get_app_store_reviews): Retrieve up to ~500 recent public reviews per storefront, sortable by most recent or most helpful.Digest & summarize reviews (
digest_app_store_reviews): Compress up to 500 reviews into a structured English digest (themes, complaints, praise, sentiment) via MCP sampling — works across foreign-language storefronts.Analyze screenshots (
get_app_store_screenshots): Fetch actual screenshot images (up to 8, iPhone or iPad) for visual analysis of positioning, onboarding flows, and paywall design.Browse top charts (
get_app_store_charts): Access top-free, top-paid, or top-grossing charts, filterable by category and country.
Key characteristics:
All tools are read-only and support a
countryparameter (ISO 3166-1 alpha-2, default:us).Responses are cached in-memory for ~15 minutes (
meta.freshflag indicates cache status).Data is sourced from Apple's public APIs and best-effort web scraping; no download counts, revenue estimates, or keyword rankings are available.
A
compare_competitorsMCP prompt packages the standard competitive analysis workflow.
Provides tools for searching, fetching metadata, comparing apps, retrieving reviews, screenshots, and top charts from the Apple App Store for competitor research and ASO analysis.
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., "@App Store MCP Server compare Duolingo and Babbel in the US App Store"
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.
appstore-mcp
An open-source MCP server for live Apple App Store competitor research.
It lets AI agents search apps, fetch public App Store metadata, compare competitors side by side, and retrieve reviews and top charts as structured JSON — for market research, ASO research, and product analysis.
It works with public competitor data only. The default, recommended uvx
setup below needs no Apple developer account, no API keys, and no database
(a separate, optional hosted alternative does require an API key — see
Hosted deployment).
Compare Duolingo, Babbel, and Busuu on the US Apple App Store.
Setup
Requires uv. Add to your MCP client config:
{
"mcpServers": {
"appstore": {
"command": "uvx",
"args": ["appstore-mcp"]
}
}
}Claude Code:
claude mcp add appstore -- uvx appstore-mcp, or install as a plugin:/plugin marketplace add LaurMost/appstore-mcpthen/plugin install appstore-mcpClaude Desktop: add the snippet above to
claude_desktop_config.jsonCursor: add the snippet above to
~/.cursor/mcp.json
If your MCP client can't find uvx, use the absolute path from which uvx as
the command.
Related MCP server: mcp-store-scraper
Hosted deployment
The uvx setup above is still the primary, recommended way to use this
server — it needs no API key. A hosted HTTP instance is also available at
https://appstore-mcp.fastmcp.app/mcp for MCP clients that need a
network-accessible endpoint instead of a local stdio process. It requires an
API key, sent as an Authorization: Bearer <key> header. See
docs/adr/0012-additive-hosted-http-mode.md
for why this is additive rather than a replacement, and the trade-offs
involved.
Tools
Tool | What it does |
| Search apps by keyword (slim results: id, name, developer, rating, price) |
| Full public profile for one app: description, release notes, ratings, versions, screenshots, subtitle, in-app-purchase flag, privacy labels |
| Batch-fetch several apps (IDs or URLs) side by side in one call |
| Recent public customer reviews (up to ~500 per storefront) |
| Compress up to 500 reviews into a structured digest (themes, complaints, praise, sentiment) via MCP sampling — raw reviews never enter your context, and foreign-language storefronts are digested in English |
| An app's screenshots as actual images, so a multimodal model can analyze visual positioning, onboarding, and paywall design |
| Top-free / top-paid / top-grossing charts, overall or per category, per country |
All tools are read-only and take a country storefront parameter (ISO
3166-1 alpha-2, default us). One MCP prompt, compare_competitors, packages
the headline comparison workflow.
Responses are compact and normalized by default; get_app_store_app accepts
include_raw=true when you want Apple's unmodified lookup payload.
Review digestion and MCP sampling
digest_app_store_reviews uses MCP sampling:
the tool asks your client's LLM to compress the reviews, so no API key is
needed. Not all MCP clients support sampling. If yours doesn't, either use
get_app_store_reviews for raw reviews, or enable the server-side fallback:
uvx "appstore-mcp[anthropic]" # + set ANTHROPIC_API_KEY
uvx "appstore-mcp[openai]" # + set OPENAI_API_KEYSet APPSTORE_MCP_SAMPLING_MODEL to override the fallback model. The digest
is LLM-generated data reduction, not ground truth — quotes may be translated
or paraphrased, and responses say so in meta.warnings.
Data sources and honest limitations
Primary source: Apple's public iTunes Search/Lookup API.
subtitle,has_iap, andprivacycome from the public App Store web page; reviews and charts come from undocumented Apple feeds. These are best-effort: when they break or return nothing, tools degrade gracefully and say so inmeta.warningsrather than failing or faking data.Not available from public Apple data, so not provided: download counts, revenue estimates, keyword rankings, full review history, historical charts.
Apps are listed per-storefront: results, ratings, and reviews differ by
country, and an app can exist in one storefront but not another.Results are cached in-memory for ~15 minutes;
meta.freshtells you whether a response came from cache.
Development
uv sync --dev
uv run pytest # offline fixture tests
uv run pytest -m live # live smoke tests against real Apple endpoints
uv run mypy
uv run ruff check . # lint
uv run ruff format . # format (Black-compatible style)fastmcp.json declares how to run the server from source (see
Project Configuration).
Use it to poke at the server directly, without a full MCP client:
fastmcp dev # launch the MCP Inspector against local source (stdio)
fastmcp run # run the server standalone (stdio)
fastmcp dev http.fastmcp.json # same, but over HTTP on localhost:8000Want a scriptable CLI instead of an MCP client? fastmcp generate-cli
connects to a running server and writes a standalone typed CLI (plus an
agent-ready SKILL.md) with one subcommand per tool - it queries over a
live connection, so a fastmcp.json/stdio target doesn't work here; start
the HTTP variant first, then point it at that:
fastmcp run http.fastmcp.json &
fastmcp generate-cli http://localhost:8000/mcp/ cli.pyThe real hosted deployment
(https://appstore-mcp.fastmcp.app/mcp, with an API key — see
Hosted deployment) works as a generate-cli/fastmcp list/fastmcp call target too, if you'd rather point at that than spin up
your own local HTTP server.
This is a local-iteration convenience only — the published package (uvx appstore-mcp) always runs over stdio via its own main() entrypoint,
regardless of what's declared here.
Some tests assert full response shapes via inline-snapshot. After an intentional change to a tool's output shape, regenerate them:
uv run pytest --inline-snapshot=fix,create # then review the diffOptionally, verify the whole stack through a real MCP client — Claude Code driving the local server over stdio against live Apple:
uv run python scripts/claude_code_integration_test.pyThis is a manual, on-demand check, not part of the default dev loop: it
requires a logged-in claude CLI and spends real
Anthropic API tokens per run.
This project is not affiliated with or endorsed by Apple. "App Store" is a trademark of Apple Inc.
License
MIT
Available Tools
7 toolscompare_app_store_appsCompare App Store appsARead-onlyIdempotent
Fetch full profiles for multiple apps (IDs or apps.apple.com URLs) in one batch for side-by-side competitor comparison. Returns the profiles plus per-app errors; apps that fail do not fail the whole call.
Inputs: apps (required), country. Returns: apps, meta, errors, sources
digest_app_store_reviewsDigest App Store reviewsARead-only
Fetch up to limit reviews and compress them into a structured
digest (themes, complaints, praise, sentiment) via MCP sampling, so
hundreds of reviews never enter your context. Works across storefront
languages - the digest is always English. Requires a client that
supports MCP sampling (or a server-side API-key fallback); use
get_app_store_reviews for the raw reviews instead.
Inputs: app_id_or_url (required), sort, focus, limit, +1 more. Returns: meta, app_id, digest, sources, +1 more
get_app_store_appGet App Store app profileARead-onlyIdempotent
Fetch the full public App Store profile for one app by numeric ID or apps.apple.com URL. Page-sourced fields (subtitle, has_iap, privacy) are best-effort; set include_page_data=false to skip that second request. Set include_raw=true to also get Apple's unmodified lookup payload (large - only when normalized fields are not enough).
Inputs: app_id_or_url (required), country, include_raw, include_page_data. Returns: app, raw, meta, sources
get_app_store_chartsGet App Store chartsARead-onlyIdempotent
Fetch ranked top-chart apps for a storefront. Best-effort: sourced from an undocumented Apple RSS feed.
Inputs: chart, limit, country, category. Returns: meta, chart, entries, sources, +1 more
get_app_store_reviewsGet App Store reviewsARead-onlyIdempotent
Fetch recent public customer reviews for an app. Best-effort: sourced from an undocumented Apple feed capped at ~500 reviews per storefront, with a small page-sourced fallback when the feed is empty. Reviews are per-country.
Inputs: app_id_or_url (required), sort, limit, country. Returns: meta, app_id, reviews, sources
get_app_store_screenshotsGet App Store screenshotsARead-onlyIdempotent
Fetch an app's App Store screenshots as actual images, so you can
analyze visual positioning, onboarding style, and paywall design
directly. Returns up to limit screenshots as image content blocks.
Inputs: app_id_or_url (required), limit, device, country.
search_app_storeSearch the Apple App StoreARead-onlyIdempotent
Search Apple App Store apps by keyword. Returns slim results (id, name, developer, rating, price) - use get_app_store_app for the full profile of a specific app.
Inputs: query (required), limit, country. Returns: meta, query, results, sources
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
Each tool targets a distinct aspect of App Store data: batch profiles, individual profiles, search, charts, raw reviews, review digests, and screenshots. No overlap in purpose.
All tools follow a consistent verb_noun pattern in snake_case, with 'app_store' as the common noun. Verbs like get, search, compare, digest are clear and predictable.
Seven tools cover the essential App Store operations without being too few or excessive. The scope is well-scoped for a focused server.
Core CRUD-like operations are present (get, search, compare), along with reviews and screenshots. Minor gap: no developer info or historical ranking data, but the main use cases are well covered.
Maintenance
Related MCP Connectors
Your agent needs app-store data — what an app looks like on the App Store and Google Play, what reviewers say, and what ranks for a search in a given country. **What you can ask for** • "What does this app's store listing look like, and how is it rated?" • "Pull recent reviews for this app and group the complaints." • "What apps rank for this search term in Japan?" • "List the top apps in this category on both stores." • "Compare this app's listing on iOS and Android." **How to use it** Point any MCP client at https://mcp.aisa.one/seo-apps/mcp and sign in with OAuth — there is no key to create or paste. 37 tools: Apple App Store and Google Play app info, app lists, category listings, reviews and store search results, in live and queued forms, with categories, languages and locations for each. **It is also a door to the rest** The same login reaches 26 sources and 580+ operations. Read the store listing here, then ask the same agent what the app's website ranks for — without adding a second server. **What it costs** Finding and inspecting an operation is free. Running one is billed per call at API prices, with no seat and no monthly minimum, and every call takes max_price_usd so an agent cannot overspend by accident. **Where else it reaches** https://mcp.aisa.one/seo/mcp for all of it at once — rankings, keywords, backlinks, site health and AI-answer visibility across DataForSEO, Semrush and Ahrefs.
ASOMobile MCP server: App Store Optimization data for the iOS App Store and Google Play inside AI agents. 29 tools: keyword research (traffic, competition, suggestions), app keyword indexing, competitors and keyword gaps, top charts and chart history, reviews with rating summaries, Apple Search Ads insights, organic download estimates and Keyword Monitor rank tracking, plus six ASO skills (app audit, keyword research, competitor audit, localization check, review analysis, ASA planning). Remote streamable HTTP with OAuth 2.1 (DCR + PKCE); sign in with your ASOMobile account.
Live App Store and Google Play data for AI agents: revenue and download estimates for 3.6M+ apps, app search and filters, ASO keyword research, reviews and listing change history. Read-only tools; API key from GetAppNiche (https://getappniche.com/mcp).
Hosted iOS app intelligence and creative research MCP server.
Related MCP Servers
- AlicenseAqualityCmaintenanceAn MCP server that provides comprehensive market intelligence by analyzing data from both the Apple App Store and Google Play Store, enabling users to research apps, track market trends, study competitors, and understand user feedback across mobile marketplaces.2049 npm26MIT
- AlicenseBqualityBmaintenanceMCP server that scrapes app data from Google Play and Apple App Store, providing tools for search, details, reviews, and similar apps.8153 npmMIT
- AlicenseNot gradedqualityDmaintenanceA remote MCP server that gives AI agents structured access to Google Play and the Apple App Store — search apps, fetch metadata, pull reviews.MIT
- AlicenseAqualityFmaintenanceAn MCP server that gives AI assistants structured access to App Store Connect data. Built for ASO analysis, download tracking, and performance monitoring.720 npm1MIT