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: Store Scraper MCP

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

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)

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

Market Analysis (1 tool)

Store Marketing (2 tools)

Search & Discovery (3 tools)

Utilities (4 tools)

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

Links

• GitHub Repository

• Sensor Tower API Docs

• Model Context Protocol

• npm Package

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