App Store MCP Server

An MCP server for searching the App Store, checking keyword rankings, analyzing competition, and tracking trends — powered by a native macOS binary for fast, direct access to App Store APIs.

Also works as a standalone CLI tool with rich output formats.

Requirements

• macOS 26+ (Apple Silicon)

Quick Start

Install via uvx (recommended)

uvx appstore-mcp-server

This downloads the native binary on first run and starts the MCP server. No persistent installation needed.

Install via pip

pip install appstore-mcp-server
appstore-mcp-server

Download binary directly

Download the latest release from GitHub Releases, extract, and run:

tar xzf appstore-*-macos-arm64.tar.gz
./appstore --mcp

MCP Client Setup

Claude Code

claude mcp add --scope user --transport stdio -- appstore-mcp-server uvx appstore-mcp-server

Or with the binary directly:

claude mcp add --scope user --transport stdio -- appstore-mcp-server /path/to/appstore --mcp

Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "appstore-mcp-server": {
      "command": "uvx",
      "args": ["appstore-mcp-server"]
    }
  }
}

Other MCP Clients

The server communicates over stdio using the standard MCP protocol. Run with --mcp flag:

/path/to/appstore --mcp

MCP Tools

| Tool | Description | |------|-------------| | search_apps | iTunes Search API with attribute/genre filtering | | search_ranked | MZStore API — results match actual App Store rankings | | lookup_app | Look up an app by ID, bundle ID, or App Store URL | | top_charts | Current top chart rankings (free, paid, grossing) | | find_app_rank | Check where an app ranks for a single keyword | | check_app_rankings | Check an app's rank across auto-generated keywords (slow) | | analyze_keyword | Competitive analysis with competitiveness score (0-100) | | app_competitors | Find an app's top competitors via overlapping search results | | compare_keywords | Compare competitiveness across multiple keywords (slow) | | discover_trending | Discover trending categories from new chart entries | | version | Get the server version |

Most tools support:

• storefront — Two-letter country code (default: US). Use for any App Store region.
• verbosity — Controls response detail and token usage:
  • compact (default) — Key fields only, no descriptions. Best for most queries.
  • full — Includes app descriptions and release notes.
  • complete — All fields from the API response. Verbose (~4KB/app).

MCP Resources

| Resource | URI | Description | |----------|-----|-------------| | Storefronts | appstore://storefronts | Country codes and names for all supported App Store regions | | Genres | appstore://genres | Genre IDs and names for App Store categories | | Search Attributes | appstore://attributes | Available search attribute names for refined searches | | Chart Types | appstore://chart-types | Available chart types for top charts queries |

MCP Prompts

| Prompt | Description | |--------|-------------| | competitive_analysis | Guided workflow: look up an app, find competitors, analyze keyword rankings, and get actionable recommendations. Args: keyword_or_app_id (required), storefront (optional). | | market_research | Guided workflow: search rankings, top charts, competitiveness analysis, trending discovery, and opportunity identification. Args: category (required), storefront (optional). |

CLI Usage

The binary doubles as a full-featured CLI tool. Run without --mcp for interactive use.

Commands

| Command | Description | |---------|-------------| | search <query> | Search the App Store (iTunes Search API) | | scrape <query> | Search with ranked results ma

... View full README on GitHub