sensor-tower-mcp

MCP (Model Context Protocol) server for SensorTower API - App Intelligence, Downloads, Revenue, Active Users, and more.

Installation

npx sensor-tower-mcp

Configuration

Add to your MCP client configuration (e.g., Claude Desktop):

{
  "mcpServers": {
    "sensor-tower-mcp": {
      "command": "npx",
      "args": ["-y", "sensor-tower-mcp"],
      "env": {
        "SENSOR_TOWER_AUTH_TOKEN": "your_auth_token_here"
      }
    }
  }
}

Available Tools

App Discovery

• discover_app_id - Parse App Store/Google Play URL to extract app ID, or get instructions for finding app ID by name

App Intelligence

• get_app_info - Get app metadata (name, publisher, categories, ratings, etc.)
• get_top_in_app_purchases - Get top in-app purchases for iOS apps

Downloads & Revenue

• get_sales_report - Get download and revenue estimates by country and date
• get_downloads_by_source - Get downloads breakdown by source (organic, paid, browser)

User Metrics

• get_active_users - Get active user estimates (DAU/WAU/MAU)
• get_retention - Get app retention data (Day 1 to Day 90)

Category Rankings

• get_category_ranking_history - Get historical category ranking
• get_category_ranking_summary - Get current category ranking summary

Advertising Intelligence

• get_ad_network_analysis - Get advertising share of voice (SOV) time series
• get_ad_network_rank - Get advertising rank across networks and countries

Reference

• list_categories - List available iOS category IDs
• list_ad_networks - List available ad networks

Prompts

analyze_app

Comprehensive app analysis workflow - automatically finds app ID and retrieves key metrics.

Arguments:
- app_name_or_url: App name, App Store URL, or Google Play URL
- platform: ios or android (required if providing app name)

compare_apps

Compare multiple apps on key metrics.

Arguments:
- apps: Comma-separated list of app names or IDs
- platform: ios or android

App ID Discovery

The server supports intelligent App ID discovery:

1. From URLs: Automatically extracts IDs from App Store or Google Play URLs

   • iOS: https://apps.apple.com/.../id284882215 → 284882215
   • Android: https://play.google.com/store/apps/details?id=com.example.app → com.example.app

2. From Names: Provides search queries to find official store pages

   • Use web search (DuckDuckGo, Tavily, etc.) to find the store URL
   • Extract the App ID from the URL

Examples

Get app info

Use get_app_info with:
- os: "ios"
- app_ids: ["284882215"]
- country: "US"

Get active users (DAU)

Use get_active_users with:
- os: "ios"
- app_ids: ["284882215"]
- time_period: "day"
- start_date: "2024-01-01"
- end_date: "2024-01-31"
- countries: ["US"]

Get sales report

Use get_sales_report with:
- os: "ios"
- app_ids: ["284882215"]
- date_granularity: "daily"
- start_date: "2024-01-01"
- end_date: "2024-01-31"
- countries: ["US", "GB", "JP"]

API Rate Limits

SensorTower API has a rate limit of 6 requests per second. The server does not implement rate limiting internally, so be mindful of request frequency.

License

MIT