appstore-mcp-server

# 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) ```bash uvx appstore-mcp-server ``` This downloads the native binary on first run and starts the MCP server. No persistent installation needed. ### Install via pip ```bash pip install appstore-mcp-server appstore-mcp-server ``` ### Download binary directly Download the latest release from [GitHub Releases](https://github.com/drewster99/appstore-mcp-server/releases), extract, and run: ```bash tar xzf appstore-*-macos-arm64.tar.gz ./appstore --mcp ``` ## MCP Client Setup ### Claude Code ```bash claude mcp add --scope user --transport stdio -- appstore-mcp-server uvx appstore-mcp-server ``` Or with the binary directly: ```bash 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`): ```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-genera…