Skip to main content
Glama
Sensor Tower MCP Server Pro

Sensor Tower MCP Server Pro

by toller892

Sensor Tower MCP Server Pro

A pure Node.js implementation of the Model Context Protocol server for Sensor Tower APIs. Access mobile app intelligence data directly in MCP-compatible tools like Cursor, Claude Desktop, and Cline.

Features

  • 23 API Tools - Production-tested and verified working tools only

  • App Intelligence - Metadata, rankings, downloads, revenue estimates

  • Search & Discovery - Find apps and publishers by name or description

  • Market Analysis - Category rankings, featured apps, competitor insights

  • Store Marketing - Keywords, reviews, featured apps data

  • Multi-Token Failover - Automatic switch to backup tokens when quota exhausted

  • No Python Required - Pure Node.js implementation

Related MCP server: AppDataLayer MCP Server

Quick Start

# Run directly with npx (recommended)
npx @feedmob/sensor-tower-mcp-pro

# Or install globally
npm install -g @feedmob/sensor-tower-mcp-pro
sensor-tower-mcp-pro

Requirements

  • Node.js 18+

  • Sensor Tower API token

MCP Configuration

Cursor / Claude Desktop / Cline

Add to your MCP settings:

{
  "mcpServers": {
    "sensortower": {
      "command": "npx",
      "args": ["-y", "@feedmob/sensor-tower-mcp-pro"],
      "env": {
        "SENSOR_TOWER_API_TOKEN": "primary_token",
        "SENSOR_TOWER_API_TOKEN_BACKUP": "backup_token"
      }
    }
  }
}

Multi-Token Failover

When a token's API quota is exhausted (429/403 error), the server automatically switches to the next available backup token. This ensures uninterrupted API access.

Environment Variables

Variable

Description

SENSOR_TOWER_API_TOKEN

Primary API token (required)

SENSOR_TOWER_API_TOKEN_BACKUP

First backup token

SENSOR_TOWER_API_TOKEN_2

Second backup token

SENSOR_TOWER_API_TOKEN_3

Third backup token (up to 10)

Example with Multiple Tokens

SENSOR_TOWER_API_TOKEN=token1 \
SENSOR_TOWER_API_TOKEN_BACKUP=token2 \
SENSOR_TOWER_API_TOKEN_2=token3 \
npx @feedmob/sensor-tower-mcp-pro

API Token

Get your API token from Sensor Tower Account Settings.

Available Tools (23 Total)

App Analysis (13 tools)

Tool

Description

get_app_metadata

App details, ratings, categories

get_download_estimates

Download trends and estimates

get_revenue_estimates

Revenue data and forecasts

get_usage_active_users

Active users data

top_in_app_purchases

Top in-app purchases

version_history

App version history

get_category_history

Category ranking history

compact_sales_report_estimates

Compact download/revenue estimates

category_ranking_summary

Today's category ranking summary

app_analysis_retention

Retention analysis data ⭐

downloads_by_sources

Downloads by source (organic/paid)

app_analysis_demographics

Demographic analysis

app_update_timeline

App update history

⭐ Fixed: app_analysis_retention now only supports all_time or quarterly for date_granularity.

Market Analysis (1 tool)

Tool

Description

get_store_summary

App store summary statistics

Store Marketing (2 tools)

Tool

Description

get_featured_today_stories

Featured Today stories

get_featured_apps

Featured apps on App Store

Search & Discovery (3 tools)

Tool

Description

get_publisher_apps

Apps by publisher

get_unified_publisher_apps

Unified publisher apps

get_app_ids_by_category

App IDs by category

Utilities (4 tools)

Tool

Description

get_country_codes

Available country codes

get_category_ids

Platform category IDs

get_chart_types

Ranking chart identifiers

health_check

Service health status

Command Line Options

npx @feedmob/sensor-tower-mcp-pro [OPTIONS]

Options:
  --transport <type>    Transport type: stdio (default) or http
  --port <port>         HTTP port (default: 8666, only for http transport)
  --token <token>       API token (or set SENSOR_TOWER_API_TOKEN env var)
  --backup-token <tok>  Backup API token for failover
  --help, -h            Show help message

Examples

# Run with stdio transport (for MCP clients)
SENSOR_TOWER_API_TOKEN=your_token npx @feedmob/sensor-tower-mcp-pro

# Run with HTTP transport
npx @feedmob/sensor-tower-mcp-pro --transport http --port 8666

Development

# Install dependencies
npm install

# Build
npm run build

# Run locally
npm start

License

MIT License


Version History

v1.4.0 (2026-02-03)

Production-Ready Release - Tested and Verified Tools Only

This release removes all failing tools based on comprehensive testing, keeping only the 23 tools that are verified to work in production.

Changes:

  • ✅ Removed 9 failing tools based on actual API testing:

    • get_creatives, get_impressions, impressions_rank (App Analysis - HTTP 422 or empty data)

    • get_featured_creatives (Store Marketing - Server bug)

    • games_breakdown, top_apps, top_apps_search (Market Analysis - Unofficial API failures)

    • sales_reports, unified_sales_reports (Your Metrics - Account connection required or server bugs)

  • ⭐ Fixed app_analysis_retention parameters:

    • Changed date_granularity to only support all_time or quarterly (was incorrectly allowing daily/weekly/monthly)

    • Added proper validation for end_date requirement when using quarterly mode

    • Updated documentation with usage examples

  • ✅ Quality improvements:

    • All 23 remaining tools are production-tested and verified

    • Removed 200+ lines of non-working code

    • Updated health_check to report correct tool count (23)

    • Comprehensive documentation updates

Tool Count: 32 → 23 tools (production-tested only)

What's Working:

  • ✅ All app metadata and information tools

  • ✅ Download and revenue estimation tools

  • ✅ Ranking and category analysis tools

  • ✅ User behavior analysis tools (with corrected parameters)

  • ✅ Publisher and discovery tools

  • ✅ Featured content tools

  • ✅ All utility tools

Migration Guide:

  • If using app_analysis_retention: Update date_granularity to all_time or quarterly only

  • If using removed tools: These tools failed in testing and should not be used

  • All remaining 23 tools are stable and production-ready

Testing: Based on comprehensive API testing documented in "SensorTower MCP 工具更新文档 2026-02-03"

v1.3.0 (2026-02-03)

Major Optimization Release - API Alignment

This release aligns the tool collection with official Sensor Tower API documentation, removing deprecated endpoints and improving reliability.

Changes:

  • ✅ Removed 11 deprecated tools that return 404 errors:

    • search_entities, get_category_rankings (Search)

    • get_top_and_trending, get_top_publishers, usage_top_apps, top_creatives (Market Analysis)

    • get_keywords, get_reviews, research_keyword (Store Marketing)

    • analytics_metrics, sources_metrics (Your Metrics)

  • ✅ Fixed parameter issues:

    • Made unified_app_ids required in unified_sales_reports

    • Clarified app_id requirement in get_featured_creatives

  • ✅ Added documentation warnings:

    • Permission requirements for sales_reports

    • Server error warnings for get_store_summary

    • Unofficial API warnings for shadow endpoints (top_apps, top_apps_search, games_breakdown)

  • ✅ Code quality improvements:

    • 343 lines of deprecated code removed

    • TypeScript compilation optimized

    • Better error messages and documentation

Tool Count: 43 → 23 tools (production-tested only)

Migration Guide:

  • If you were using removed tools, check the official Sensor Tower API docs for alternative endpoints

  • Shadow API tools (marked with ⚠️) still work but may change without notice

v1.2.13 (2026-01-30)

  • Fixed API endpoint paths and date parameter handling

  • Improved error handling

v1.2.12 (2026-01-30)

  • Initial npm release

  • 43 API tools with multi-token failover support

Available Tools

23 tools
app_analysis_demographicsC

Get demographic analysis data for apps.

Inputs: os (required), app_ids (required), start_date (required), date_granularity (required), +2 more.

app_analysis_retentionA

Get retention analysis data for apps.

⚠️ IMPORTANT: date_granularity only supports "all_time" or "quarterly". When using "quarterly", end_date is required.

Inputs: os (required), app_ids (required), start_date (required), date_granularity (required), +2 more.

app_update_timelineC

Get app update history timeline.

Inputs: os (required), app_id (required), country, date_limit.

category_ranking_summaryB

Get today's category ranking summary for a particular app.

Inputs: os (required), app_id (required), country (required).

compact_sales_report_estimatesC

Get download and revenue estimates in compact format.

Inputs: os (required), end_date (required), start_date (required), app_ids, +7 more.

downloads_by_sourcesB

Get app downloads by sources (organic, paid, browser).

Inputs: os (required), app_ids (required), end_date (required), countries (required), +2 more.

get_app_ids_by_categoryB

Retrieve app IDs by category and release/update date filters.

Inputs: os (required), category (required), limit, offset, +2 more.

get_app_metadataC

Get comprehensive app metadata including descriptions, ratings, and more.

Inputs: os (required), app_ids (required), country, include_sdk_data.

get_category_historyC

Get category ranking history for apps.

Inputs: os (required), app_ids (required), category (required), end_date (required), +3 more.

get_category_idsB

Get list of category IDs for iOS or Android.

Inputs: os (required).

get_chart_typesA

List available ranking chart identifiers used by Sensor Tower.

Inputs: no named parameters.

get_country_codesA

Get list of available country codes for Sensor Tower API.

Inputs: no named parameters.

get_download_estimatesB

Fetch download estimates for apps by country and date.

Inputs: os (required), app_ids (required), end_date (required), start_date (required), +3 more.

get_publisher_appsC

Retrieve apps for the specified publisher.

Inputs: os (required), publisher_id (required), limit, offset, +1 more.

get_revenue_estimatesB

Fetch revenue estimates for apps by country and date.

Inputs: os (required), app_ids (required), end_date (required), start_date (required), +3 more.

get_store_summaryA

Get app store summary statistics.

⚠️ TEMPORARILY DISABLED: This endpoint is currently returning 500 Internal Server Error from Sensor Tower's API. This is a server-side issue. Please contact Sensor Tower support or try again later.

Inputs: os (required), end_date (required), categories (required), start_date (required), +2 more.

get_unified_publisher_appsC

Retrieve unified publisher details and associated apps.

Inputs: unified_id (required).

get_usage_active_usersC

Get usage intelligence active users data.

Inputs: os (required), app_ids (required), end_date (required), start_date (required), +3 more.

health_checkC

Lightweight status endpoint for monitoring and orchestration.

Inputs: no named parameters.

top_in_app_purchasesB

Retrieve top in-app purchases for the requested app IDs.

Inputs: os (required), app_ids (required), country.

version_historyA

Get version history for a particular app.

Inputs: os (required), app_id (required), country.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2.8/5.0

    Scored across 23 tools

    Disambiguation2/5

    Several tools have overlapping purposes, such as version_history and app_update_timeline both covering app update history, and compact_sales_report_estimates duplicating download/revenue estimates. While descriptions hint at differences, the boundaries are unclear, making misselection likely.

    Naming Consistency2/5

    Naming is inconsistent: many tools use get_ prefix (get_app_metadata, get_download_estimates), but others are noun phrases without verbs (version_history, category_ranking_summary, downloads_by_sources, top_in_app_purchases). No uniform verb_noun or noun_verb pattern emerges.

    Tool Count3/5

    At 23 tools, the set is on the heavy side but appropriate for a broad analytics platform covering many data types. Not excessive enough to warrant a 2, but above the ideal 3-15 range.

    Completeness4/5

    The tool set covers major Sensor Tower capabilities: metadata, estimates, usage, rankings, retention, demographics, publisher info, and reference data. Missing review-level data or advanced ad intelligence, but core workflows are represented. Slight gaps around update/delete operations are irrelevant for a read-only analytics API.

    Related MCP Connectors

    Related MCP Servers

    • -
      license
      Not graded
      quality
      Not graded
      maintenance
      Empowers users to search and analyze mobile apps via the AppTweak API, providing insights into app store data, reviews, ratings, and keyword performance on iOS and Android platforms.
      -
    • A
      license
      Not graded
      quality
      Not graded
      maintenance
      An app intelligence query engine that enables analysis of over 1 billion reviews from Google Play and the Apple App Store. It provides tools for sentiment analysis, keyword rankings, competitive comparisons, and time-series forecasting across 250,000+ apps.
      16 npm
      2
      -
    • F
      license
      Not graded
      quality
      D
      maintenance
      Provides MCP tools to search and retrieve Apple App Store and Google Play app data, including app details, reviews, charts, developer info, and ASO keyword/rank estimates.
      -
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables retrieval of App Store and Google Play reviews, ratings summaries, and ASO keyword rankings for any app using its store ID or package name.
      81 npm
      MIT