Sensor Tower MCP Server Pro
Provides tools to access mobile app intelligence data from the App Store, including app metadata, downloads, revenue estimates, rankings, featured apps, and more via the Sensor Tower API.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Sensor Tower MCP Server Pro Show download estimates for TikTok in the US"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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-proRequirements
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 |
| Primary API token (required) |
| First backup token |
| Second backup token |
| 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-proAPI Token
Get your API token from Sensor Tower Account Settings.
Available Tools (23 Total)
App Analysis (13 tools)
Tool | Description |
| App details, ratings, categories |
| Download trends and estimates |
| Revenue data and forecasts |
| Active users data |
| Top in-app purchases |
| App version history |
| Category ranking history |
| Compact download/revenue estimates |
| Today's category ranking summary |
| Retention analysis data ⭐ |
| Downloads by source (organic/paid) |
| Demographic analysis |
| App update history |
⭐ Fixed:
app_analysis_retentionnow only supportsall_timeorquarterlyfor date_granularity.
Market Analysis (1 tool)
Tool | Description |
| App store summary statistics |
Store Marketing (2 tools)
Tool | Description |
| Featured Today stories |
| Featured apps on App Store |
Search & Discovery (3 tools)
Tool | Description |
| Apps by publisher |
| Unified publisher apps |
| App IDs by category |
Utilities (4 tools)
Tool | Description |
| Available country codes |
| Platform category IDs |
| Ranking chart identifiers |
| 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 messageExamples
# 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 8666Development
# Install dependencies
npm install
# Build
npm run build
# Run locally
npm startLinks
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_retentionparameters:Changed
date_granularityto only supportall_timeorquarterly(was incorrectly allowing daily/weekly/monthly)Added proper validation for
end_daterequirement when using quarterly modeUpdated 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: Updatedate_granularitytoall_timeorquarterlyonlyIf 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_idsrequired inunified_sales_reportsClarified
app_idrequirement inget_featured_creatives
✅ Added documentation warnings:
Permission requirements for
sales_reportsServer error warnings for
get_store_summaryUnofficial 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 toolsapp_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_featured_appsB
Retrieve featured apps on the App Store Apps & Games pages.
Inputs: category (required), country, end_date, start_date.
get_featured_today_storiesB
Retrieve featured Today stories from the App Store.
Inputs: country, end_date, start_date.
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
Scored across 23 tools
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 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.
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.
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
App intelligence across Google Play and the App Store: details, reviews, and search in one API.
App Store keyword rankings, competitors, markets, reviews and analytics for iOS apps, from your AI.
Live App Store and Google Play data: app details, reviews, search, top charts for 175+ storefronts.
Track your apps' keyword rankings, reviews and store listings on App Store, Google Play and more.
Related MCP Servers
- -licenseNot gradedqualityNot gradedmaintenanceEmpowers 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.-
- AlicenseNot gradedqualityNot gradedmaintenanceAn 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 npm2-
- FlicenseNot gradedqualityDmaintenanceProvides 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.-
- AlicenseNot gradedqualityBmaintenanceEnables 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 npmMIT