Skip to main content
Glama
App Store MCP Server

App Store MCP Server

by LaurMost

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-mcp then /plugin install appstore-mcp

  • Claude Desktop: add the snippet above to claude_desktop_config.json

  • Cursor: 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_app_store

Search apps by keyword (slim results: id, name, developer, rating, price)

get_app_store_app

Full public profile for one app: description, release notes, ratings, versions, screenshots, subtitle, in-app-purchase flag, privacy labels

compare_app_store_apps

Batch-fetch several apps (IDs or URLs) side by side in one call

get_app_store_reviews

Recent public customer reviews (up to ~500 per storefront)

digest_app_store_reviews

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

get_app_store_screenshots

An app's screenshots as actual images, so a multimodal model can analyze visual positioning, onboarding, and paywall design

get_app_store_charts

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_KEY

Set 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, and privacy come 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 in meta.warnings rather 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.fresh tells 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:8000

Want 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.py

The 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 diff

Optionally, 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.py

This 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 tools
compare_app_store_appsCompare App Store appsA
Read-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 reviewsA
Read-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 profileA
Read-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 chartsA
Read-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 reviewsA
Read-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 screenshotsA
Read-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 StoreA
Read-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

    A4.4/5.0

    Scored across 7 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    Seven tools cover the essential App Store operations without being too few or excessive. The scope is well-scoped for a focused server.

    Completeness4/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    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.

      https://mcp.asomobile.net/mcp
    • 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).

      https://api.getappniche.com/mcp
    • Hosted iOS app intelligence and creative research MCP server.

      https://mcp.peekpanda.com/mcp

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      An 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.
      20
      49 npm
      26
      MIT
    • A
      license
      B
      quality
      B
      maintenance
      MCP server that scrapes app data from Google Play and Apple App Store, providing tools for search, details, reviews, and similar apps.
      8
      153 npm
      MIT