sensor-tower-mcp-pro 1.2.10 → 1.2.12

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +70 -16
  2. package/package.json +9 -7
package/README.md CHANGED
@@ -1,12 +1,14 @@
1
- # Sensor Tower MCP Server (npm)
1
+ # Sensor Tower MCP Server Pro
2
2
 
3
- 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 and Claude Desktop.
3
+ 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.
4
4
 
5
5
  ## Features
6
6
 
7
+ - **43 API Tools** - Complete coverage of Sensor Tower APIs
7
8
  - **App Intelligence** - Metadata, rankings, downloads, revenue estimates
8
9
  - **Search & Discovery** - Find apps and publishers by name or description
9
10
  - **Market Analysis** - Category rankings, featured apps, competitor insights
11
+ - **Store Marketing** - Keywords, reviews, featured apps data
10
12
  - **Multi-Token Failover** - Automatic switch to backup tokens when quota exhausted
11
13
  - **No Python Required** - Pure Node.js implementation
12
14
 
@@ -14,11 +16,11 @@ A pure Node.js implementation of the Model Context Protocol server for Sensor To
14
16
 
15
17
  ```bash
16
18
  # Run directly with npx (recommended)
17
- npx sensortower-mcp
19
+ npx sensor-tower-mcp-pro
18
20
 
19
21
  # Or install globally
20
- npm install -g sensortower-mcp
21
- sensortower-mcp
22
+ npm install -g sensor-tower-mcp-pro
23
+ sensor-tower-mcp-pro
22
24
  ```
23
25
 
24
26
  ## Requirements
@@ -28,7 +30,7 @@ sensortower-mcp
28
30
 
29
31
  ## MCP Configuration
30
32
 
31
- ### Cursor / Claude Desktop
33
+ ### Cursor / Claude Desktop / Cline
32
34
 
33
35
  Add to your MCP settings:
34
36
 
@@ -37,7 +39,7 @@ Add to your MCP settings:
37
39
  "mcpServers": {
38
40
  "sensortower": {
39
41
  "command": "npx",
40
- "args": ["-y", "sensortower-mcp"],
42
+ "args": ["-y", "sensor-tower-mcp-pro"],
41
43
  "env": {
42
44
  "SENSOR_TOWER_API_TOKEN": "primary_token",
43
45
  "SENSOR_TOWER_API_TOKEN_BACKUP": "backup_token"
@@ -66,33 +68,86 @@ When a token's API quota is exhausted (429/403 error), the server automatically
66
68
  SENSOR_TOWER_API_TOKEN=token1 \
67
69
  SENSOR_TOWER_API_TOKEN_BACKUP=token2 \
68
70
  SENSOR_TOWER_API_TOKEN_2=token3 \
69
- npx sensortower-mcp
71
+ npx sensor-tower-mcp-pro
70
72
  ```
71
73
 
72
74
  ## API Token
73
75
 
74
76
  Get your API token from [Sensor Tower Account Settings](https://app.sensortower.com/users/edit/api-settings).
75
77
 
76
- ## Available Tools
78
+ ## Available Tools (43 Total)
77
79
 
80
+ ### App Analysis (16 tools)
78
81
  | Tool | Description |
79
82
  |------|-------------|
80
83
  | `get_app_metadata` | App details, ratings, categories |
81
- | `search_entities` | Search apps and publishers |
82
- | `get_category_rankings` | Top apps by category |
83
84
  | `get_download_estimates` | Download trends and estimates |
84
85
  | `get_revenue_estimates` | Revenue data and forecasts |
85
86
  | `get_creatives` | Advertising creatives |
87
+ | `get_impressions` | Advertising impressions data |
86
88
  | `get_usage_active_users` | Active users data |
87
89
  | `top_in_app_purchases` | Top in-app purchases |
88
90
  | `version_history` | App version history |
91
+ | `get_category_history` | Category ranking history |
92
+ | `compact_sales_report_estimates` | Compact download/revenue estimates |
93
+ | `category_ranking_summary` | Today's category ranking summary |
94
+ | `impressions_rank` | Advertising impressions rank |
95
+ | `app_analysis_retention` | Retention analysis data |
96
+ | `downloads_by_sources` | Downloads by source (organic/paid) |
97
+ | `app_analysis_demographics` | Demographic analysis |
98
+ | `app_update_timeline` | App update history |
99
+
100
+ ### Market Analysis (8 tools)
101
+ | Tool | Description |
102
+ |------|-------------|
103
+ | `get_top_and_trending` | Top apps by downloads/revenue |
104
+ | `get_top_publishers` | Top publishers ranking |
105
+ | `get_store_summary` | App store summary statistics |
106
+ | `usage_top_apps` | Top apps by active users |
107
+ | `top_apps` | Share of Voice for advertisers/publishers |
108
+ | `top_apps_search` | Rank of advertiser/publisher |
109
+ | `top_creatives` | Top creatives over time |
110
+ | `games_breakdown` | Game category breakdown |
111
+
112
+ ### Store Marketing (6 tools)
113
+ | Tool | Description |
114
+ |------|-------------|
115
+ | `get_featured_today_stories` | Featured Today stories |
116
+ | `get_featured_apps` | Featured apps on App Store |
117
+ | `get_featured_creatives` | Featured creatives and positions |
118
+ | `get_keywords` | Current keyword rankings |
119
+ | `get_reviews` | App reviews and ratings |
120
+ | `research_keyword` | Keyword research metadata |
121
+
122
+ ### Search & Discovery (5 tools)
123
+ | Tool | Description |
124
+ |------|-------------|
125
+ | `search_entities` | Search apps and publishers |
126
+ | `get_category_rankings` | Top apps by category |
127
+ | `get_publisher_apps` | Apps by publisher |
128
+ | `get_unified_publisher_apps` | Unified publisher apps |
129
+ | `get_app_ids_by_category` | App IDs by category |
130
+
131
+ ### Your Metrics (4 tools)
132
+ | Tool | Description |
133
+ |------|-------------|
134
+ | `analytics_metrics` | App Store analytics report |
135
+ | `sources_metrics` | Metrics by traffic source |
136
+ | `sales_reports` | Downloads/revenue sales report |
137
+ | `unified_sales_reports` | Unified sales report |
138
+
139
+ ### Utilities (4 tools)
140
+ | Tool | Description |
141
+ |------|-------------|
89
142
  | `get_country_codes` | Available country codes |
90
143
  | `get_category_ids` | Platform category IDs |
144
+ | `get_chart_types` | Ranking chart identifiers |
145
+ | `health_check` | Service health status |
91
146
 
92
147
  ## Command Line Options
93
148
 
94
149
  ```bash
95
- npx sensortower-mcp [OPTIONS]
150
+ npx sensor-tower-mcp-pro [OPTIONS]
96
151
 
97
152
  Options:
98
153
  --transport <type> Transport type: stdio (default) or http
@@ -106,10 +161,10 @@ Options:
106
161
 
107
162
  ```bash
108
163
  # Run with stdio transport (for MCP clients)
109
- SENSOR_TOWER_API_TOKEN=your_token npx sensortower-mcp
164
+ SENSOR_TOWER_API_TOKEN=your_token npx sensor-tower-mcp-pro
110
165
 
111
166
  # Run with HTTP transport
112
- npx sensortower-mcp --transport http --port 8666
167
+ npx sensor-tower-mcp-pro --transport http --port 8666
113
168
  ```
114
169
 
115
170
  ## Development
@@ -127,10 +182,9 @@ npm start
127
182
 
128
183
  ## Links
129
184
 
130
- - [GitHub Repository](https://github.com/sensortower/sensortower-mcp)
131
185
  - [Sensor Tower API Docs](https://docs.sensortower.com/)
132
186
  - [Model Context Protocol](https://modelcontextprotocol.io/)
133
187
 
134
188
  ## License
135
189
 
136
- MIT License
190
+ MIT License
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "sensor-tower-mcp-pro",
3
- "version": "1.2.10",
4
- "description": "Model Context Protocol server for Sensor Tower APIs - Access mobile app intelligence data",
3
+ "version": "1.2.12",
4
+ "description": "Model Context Protocol server for Sensor Tower APIs - Access mobile app intelligence data with dual token support",
5
5
  "main": "dist/index.js",
6
6
  "types": "dist/index.d.ts",
7
7
  "bin": {
@@ -24,17 +24,19 @@
24
24
  "play-store",
25
25
  "ai",
26
26
  "claude",
27
- "cursor"
27
+ "cursor",
28
+ "dual-token",
29
+ "failover"
28
30
  ],
29
- "author": "SensorTower",
31
+ "author": "toller892",
30
32
  "license": "MIT",
31
33
  "repository": {
32
34
  "type": "git",
33
- "url": "https://github.com/sensortower/sensortower-mcp"
35
+ "url": "https://github.com/toller892/SensorTower_mcp"
34
36
  },
35
- "homepage": "https://github.com/sensortower/sensortower-mcp",
37
+ "homepage": "https://github.com/toller892/SensorTower_mcp",
36
38
  "bugs": {
37
- "url": "https://github.com/sensortower/sensortower-mcp/issues"
39
+ "url": "https://github.com/toller892/SensorTower_mcp/issues"
38
40
  },
39
41
  "engines": {
40
42
  "node": ">=18.0.0"