Sensor Tower Reporting MCP Server

This MCP server provides tools to interact with the Sensor Tower API for mobile app intelligence and market data.

Features

• Tools:

  • get_app_metadata: Fetch app metadata including name, publisher, categories, description, screenshots, and ratings
  • get_top_in_app_purchases: Fetch top in-app purchases for iOS apps
  • get_compact_sales_report_estimates: Get download and revenue estimates in compact format (revenues in cents)
  • get_active_users: Fetch active user estimates (DAU/WAU/MAU) by country and date
  • get_category_history: Get detailed category ranking history for apps
  • get_category_ranking_summary: Fetch today's category ranking summary
  • get_network_analysis: Get impressions share of voice (SOV) time series
  • get_network_analysis_rank: Fetch network analysis ranking data
  • get_retention: Get app retention data (day 1 to day 90)
  • get_downloads_by_sources: Fetch app downloads by sources (organic, paid, browser)
  • find_apps_by_metric_threshold: Discover apps exceeding a download/revenue threshold over a given time period and geography

• Data Files:

  • data/category_ids.json: Category ID reference for iOS and Android
  • data/country_ids.json: Country code reference

Setup

1. Install dependencies:

   npm install

2. Configure environment variables: Create a .env file with the following variables:

   AUTH_TOKEN=your_sensor_tower_auth_token
   SENSOR_TOWER_BASE_URL=https://api.sensortower.com

3. Build the server:

   npm run build

Running the Server

To run the server directly for testing:

npm start

For development with hot reload:

npm run dev

Usage with Claude Desktop

1. Make sure you have installed and updated to the latest version of Claude for Desktop.
2. Open the Claude for Desktop configuration file:
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
3. Add the Sensor Tower Reporting MCP server to the configuration:

NPX

{
  "mcpServers": {
    "sensor-tower-reporting": {
      "command": "npx",
      "args": ["-y", "@feedmob/sensor-tower-reporting"],
      "env": {
        "AUTH_TOKEN": "your_sensor_tower_auth_token",
        "SENSOR_TOWER_BASE_URL": "https://api.sensortower.com"
      }
    }
  }
}

Local Development

{
  "mcpServers": {
    "sensor-tower-reporting": {
      "command": "node",
      "args": ["dist/index.js"],
      "cwd": "/path/to/sensor-tower-reporting",
      "env": {
        "AUTH_TOKEN": "your_sensor_tower_auth_token",
        "SENSOR_TOWER_BASE_URL": "https://api.sensortower.com"
      }
    }
  }
}

API Reference

App Metadata

• Platform Support: iOS, Android
• Limits: Maximum 100 app IDs per request
• Returns: App name, publisher, categories, description, screenshots, ratings

Sales & Revenue Data

• Compact Sales Report: Download and revenue estimates with flexible filtering
• Revenue Format: All revenues returned in cents
• Filtering: By app IDs, publisher IDs, unified IDs, or categories

User Analytics

• Active Users: DAU/WAU/MAU estimates by country and time period
• Retention: Day 1 to day 90 retention rates with baseline comparison
• Limits: Maximum 500 app IDs for active users and retention

Ranking & Category Data

• Category History: Detailed ranking history by category and chart type
• Category Summary: Current ranking summary for specific apps
• Hourly Rankings: Available for iOS apps

Advertising Intelligence

• Network Analysis: Share of voice (SOV) for advertising networks
• Network Rankings: Ranking data across countries and networks
• Downloads by Sources: Organic vs paid download attribution

Market Research

• Find Apps by Metric Threshold: Discover apps exceeding a download or revenue threshold in a given time range, category, and geography. OS defaults to iOS when not specified.

Error Handling

The server includes comprehensive error handling with specific error types:

• ConfigurationError: Missing or invalid configuration
• SensorTowerApiError: API-related errors with detailed messages
• Input validation using Zod schemas for all parameters

Environment Variables

| Variable | Required | Description | Default | |----------|----------|-------------|---------| | AUTH_TOKEN | Yes | Sensor Tower API authentication token | - | | SENSOR_TOWER_BASE_URL | No | Sensor Tower API base URL | https://api.sensortower.com |

Development

Scripts

• npm run build: Compile TypeScript and make executables
• npm run watch: Watch mode for development
• npm run prepare: Prepare package for publishing

Testing

Use the MCP inspector for manual testing:

npm run inspect

License

MIT