AppRanks MCP Server

An MCP (Model Context Protocol) server that provides live App Store rankings data from AppRanks.app.

Browse charts, search apps, view rankings, read reviews — all from your AI assistant.

Tools

| Tool | Description | |------|-------------| | get_chart | Browse App Store charts (top free, paid, grossing) by country, platform, category | | search_apps | Search apps by name or developer | | get_app | Get app details with current rankings across all countries | | get_rank_history | View ranking history over time | | get_reviews | Read App Store reviews by country | | list_countries | List all 55 supported countries | | list_categories | List all App Store categories with IDs |

Coverage

• 55 countries across Americas, Europe, Middle East, Africa, and Asia Pacific
• 4 platforms: iPhone, iPad, Mac, Apple TV
• 43 categories including game subcategories
• 3 chart types: Top Free, Top Paid, Top Grossing
• Updated every 4 hours

Setup

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "appranks": {
      "command": "npx",
      "args": ["-y", "@appranks.app/mcp-server"]
    }
  }
}

Claude Code

claude mcp add appranks -- npx -y @appranks.app/mcp-server

Manual

npx @appranks.app/mcp-server

Examples

Ask your AI assistant:

• "What are the top 10 free iPhone apps in Japan?"
• "Search for weather apps"
• "Show me Netflix's rankings across all countries"
• "What's the ranking history for Spotify in the US over the last 30 days?"
• "Show me 1-star reviews for TikTok in Germany"

Configuration

| Environment Variable | Default | Description | |---------------------|---------|-------------| | APPRANKS_API_URL | https://appranks.app/api/v1 | API base URL |

License

MIT