sensor-tower-mcp-pro 1.2.10

package/README.md

@@ -0,0 +1,136 @@
+# Sensor Tower MCP Server (npm)
+
+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.
+
+## Features
+
+- **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
+- **Multi-Token Failover** - Automatic switch to backup tokens when quota exhausted
+- **No Python Required** - Pure Node.js implementation
+
+## Quick Start
+
+```bash
+# Run directly with npx (recommended)
+npx sensortower-mcp
+
+# Or install globally
+npm install -g sensortower-mcp
+sensortower-mcp
+```
+
+## Requirements
+
+- **Node.js 18+**
+- Sensor Tower API token
+
+## MCP Configuration
+
+### Cursor / Claude Desktop
+
+Add to your MCP settings:
+
+```json
+{
+  "mcpServers": {
+    "sensortower": {
+      "command": "npx",
+      "args": ["-y", "sensortower-mcp"],
+      "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
+
+```bash
+SENSOR_TOWER_API_TOKEN=token1 \
+SENSOR_TOWER_API_TOKEN_BACKUP=token2 \
+SENSOR_TOWER_API_TOKEN_2=token3 \
+npx sensortower-mcp
+```
+
+## API Token
+
+Get your API token from [Sensor Tower Account Settings](https://app.sensortower.com/users/edit/api-settings).
+
+## Available Tools
+
+| Tool | Description |
+|------|-------------|
+| `get_app_metadata` | App details, ratings, categories |
+| `search_entities` | Search apps and publishers |
+| `get_category_rankings` | Top apps by category |
+| `get_download_estimates` | Download trends and estimates |
+| `get_revenue_estimates` | Revenue data and forecasts |
+| `get_creatives` | Advertising creatives |
+| `get_usage_active_users` | Active users data |
+| `top_in_app_purchases` | Top in-app purchases |
+| `version_history` | App version history |
+| `get_country_codes` | Available country codes |
+| `get_category_ids` | Platform category IDs |
+
+## Command Line Options
+
+```bash
+npx sensortower-mcp [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
+
+```bash
+# Run with stdio transport (for MCP clients)
+SENSOR_TOWER_API_TOKEN=your_token npx sensortower-mcp
+
+# Run with HTTP transport
+npx sensortower-mcp --transport http --port 8666
+```
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Build
+npm run build
+
+# Run locally
+npm start
+```
+
+## Links
+
+- [GitHub Repository](https://github.com/sensortower/sensortower-mcp)
+- [Sensor Tower API Docs](https://docs.sensortower.com/)
+- [Model Context Protocol](https://modelcontextprotocol.io/)
+
+## License
+
+MIT License

package/bin/sensortower-mcp.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+require('../dist/index.js');

package/dist/client.d.ts

@@ -0,0 +1,17 @@
+/**
+ * HTTP client for Sensor Tower API
+ */
+export declare class SensorTowerClient {
+    private tokens;
+    private currentTokenIndex;
+    constructor(tokens: string[]);
+    private getAuthToken;
+    private switchToBackupToken;
+    getTokenStatus(): {
+        current: number;
+        total: number;
+    };
+    makeRequest<T>(endpoint: string, params: Record<string, any>): Promise<T>;
+    private sleep;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAW;IACzB,OAAO,CAAC,iBAAiB,CAAa;gBAE1B,MAAM,EAAE,MAAM,EAAE;IAO5B,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,mBAAmB;IAU3B,cAAc,IAAI;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE;IAO9C,WAAW,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAsE/E,OAAO,CAAC,KAAK;CAGd"}

package/dist/client.js

@@ -0,0 +1,100 @@
+"use strict";
+/**
+ * HTTP client for Sensor Tower API
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SensorTowerClient = void 0;
+const config_1 = require("./config");
+class SensorTowerClient {
+    tokens;
+    currentTokenIndex = 0;
+    constructor(tokens) {
+        if (tokens.length === 0) {
+            throw new Error('At least one API token is required');
+        }
+        this.tokens = tokens;
+    }
+    getAuthToken() {
+        return this.tokens[this.currentTokenIndex];
+    }
+    switchToBackupToken() {
+        if (this.currentTokenIndex < this.tokens.length - 1) {
+            this.currentTokenIndex++;
+            console.error(`⚠️ Token #${this.currentTokenIndex} quota exceeded, switching to token #${this.currentTokenIndex + 1}`);
+            return true;
+        }
+        console.error(`❌ All ${this.tokens.length} tokens exhausted`);
+        return false;
+    }
+    getTokenStatus() {
+        return {
+            current: this.currentTokenIndex + 1,
+            total: this.tokens.length,
+        };
+    }
+    async makeRequest(endpoint, params) {
+        params.auth_token = this.getAuthToken();
+        let backoffMs = 500;
+        const maxAttempts = 5;
+        for (let attempt = 0; attempt < maxAttempts; attempt++) {
+            try {
+                const url = new URL(endpoint, config_1.API_BASE_URL);
+                Object.entries(params).forEach(([key, value]) => {
+                    if (value !== undefined && value !== null) {
+                        url.searchParams.append(key, String(value));
+                    }
+                });
+                const response = await fetch(url.toString(), {
+                    method: 'GET',
+                    headers: {
+                        'Accept': 'application/json',
+                    },
+                });
+                if (!response.ok) {
+                    const statusCode = response.status;
+                    // Check for quota/rate limit errors
+                    let isQuotaError = statusCode === 429;
+                    if (statusCode === 403) {
+                        try {
+                            const errorBody = await response.text();
+                            const errorMessage = errorBody.toLowerCase();
+                            isQuotaError = ['quota', 'limit', 'exceeded', 'rate'].some(keyword => errorMessage.includes(keyword));
+                        }
+                        catch {
+                            // Ignore parse errors
+                        }
+                    }
+                    // Try backup token on quota errors
+                    if (isQuotaError && this.switchToBackupToken()) {
+                        params.auth_token = this.getAuthToken();
+                        console.error('Retrying request with backup token...');
+                        continue;
+                    }
+                    // Retry on server errors
+                    if ([429, 500, 502, 503, 504].includes(statusCode) && attempt < maxAttempts - 1) {
+                        await this.sleep(backoffMs);
+                        backoffMs = Math.min(backoffMs * 2, 8000);
+                        continue;
+                    }
+                    throw new Error(`HTTP ${statusCode}: ${response.statusText}`);
+                }
+                return await response.json();
+            }
+            catch (error) {
+                if (attempt < maxAttempts - 1 && error instanceof TypeError) {
+                    // Network error, retry
+                    await this.sleep(backoffMs);
+                    backoffMs = Math.min(backoffMs * 2, 8000);
+                    continue;
+                }
+                throw error;
+            }
+        }
+        throw new Error('Max retry attempts exceeded');
+    }
+    sleep(ms) {
+        return new Promise(resolve => setTimeout(resolve, ms));
+    }
+}
+exports.SensorTowerClient = SensorTowerClient;
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/config.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Configuration for Sensor Tower MCP Server
+ */
+export declare const API_BASE_URL: string;
+export interface Config {
+    tokens: string[];
+    transport: 'stdio' | 'http';
+    port: number;
+}
+export declare function getConfig(): Config;
+export declare function parseArgs(): Config;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,eAAO,MAAM,YAAY,QAA4D,CAAC;AAEtF,MAAM,WAAW,MAAM;IACrB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,SAAS,EAAE,OAAO,GAAG,MAAM,CAAC;IAC5B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,SAAS,IAAI,MAAM,CAclC;AA2BD,wBAAgB,SAAS,IAAI,MAAM,CA6ClC"}

package/dist/config.js

@@ -0,0 +1,142 @@
+"use strict";
+/**
+ * Configuration for Sensor Tower MCP Server
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.API_BASE_URL = void 0;
+exports.getConfig = getConfig;
+exports.parseArgs = parseArgs;
+exports.API_BASE_URL = process.env.API_BASE_URL || 'https://api.sensortower.com';
+function getConfig() {
+    const tokens = collectTokensFromEnv();
+    if (tokens.length === 0) {
+        console.error('Error: SENSOR_TOWER_API_TOKEN environment variable is required');
+        console.error('Get your API token from: https://app.sensortower.com/users/edit/api-settings');
+        process.exit(1);
+    }
+    return {
+        tokens,
+        transport: process.env.TRANSPORT || 'stdio',
+        port: parseInt(process.env.PORT || '8666', 10),
+    };
+}
+/**
+ * Collect all tokens from environment variables
+ * Supports: SENSOR_TOWER_API_TOKEN, SENSOR_TOWER_API_TOKEN_BACKUP,
+ *           SENSOR_TOWER_API_TOKEN_2, SENSOR_TOWER_API_TOKEN_3, etc.
+ */
+function collectTokensFromEnv() {
+    const tokens = [];
+    // Primary token
+    const primary = process.env.SENSOR_TOWER_API_TOKEN;
+    if (primary)
+        tokens.push(primary);
+    // Backup token (legacy support)
+    const backup = process.env.SENSOR_TOWER_API_TOKEN_BACKUP;
+    if (backup)
+        tokens.push(backup);
+    // Additional numbered tokens (2, 3, 4, ...)
+    for (let i = 2; i <= 10; i++) {
+        const token = process.env[`SENSOR_TOWER_API_TOKEN_${i}`];
+        if (token)
+            tokens.push(token);
+    }
+    return tokens;
+}
+function parseArgs() {
+    const args = process.argv.slice(2);
+    const tokens = [];
+    let transport = 'stdio';
+    let port = 8666;
+    // First collect from environment
+    tokens.push(...collectTokensFromEnv());
+    for (let i = 0; i < args.length; i++) {
+        switch (args[i]) {
+            case '--token':
+                // Primary token from CLI overrides env
+                const cliToken = args[++i];
+                if (cliToken && !tokens.includes(cliToken)) {
+                    tokens.unshift(cliToken); // Add to front as primary
+                }
+                break;
+            case '--backup-token':
+                // Add backup token
+                const backupToken = args[++i];
+                if (backupToken && !tokens.includes(backupToken)) {
+                    tokens.push(backupToken);
+                }
+                break;
+            case '--transport':
+                transport = args[++i];
+                break;
+            case '--port':
+                port = parseInt(args[++i] || '8666', 10);
+                break;
+            case '--help':
+            case '-h':
+                printHelp();
+                process.exit(0);
+        }
+    }
+    if (tokens.length === 0) {
+        console.error('Error: SENSOR_TOWER_API_TOKEN environment variable or --token argument is required');
+        console.error('Get your API token from: https://app.sensortower.com/users/edit/api-settings');
+        process.exit(1);
+    }
+    return { tokens, transport, port };
+}
+function printHelp() {
+    console.log(`
+Sensor Tower MCP Server
+
+A Model Context Protocol server for accessing Sensor Tower's mobile app intelligence APIs.
+
+USAGE:
+  npx sensortower-mcp [OPTIONS]
+
+OPTIONS:
+  --transport <type>    Transport type: stdio (default) or http
+  --port <port>         HTTP port (default: 8666, only for http transport)
+  --token <token>       Primary API token (or set SENSOR_TOWER_API_TOKEN env var)
+  --backup-token <tok>  Backup API token for failover (can use multiple times)
+  --help, -h            Show this help message
+
+ENVIRONMENT VARIABLES:
+  SENSOR_TOWER_API_TOKEN          Primary API token
+  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)
+
+TOKEN FAILOVER:
+  When a token's quota is exhausted (429/403 error), the server automatically
+  switches to the next available backup token. This ensures uninterrupted
+  API access across multiple tokens.
+
+EXAMPLES:
+  # Run with single token
+  SENSOR_TOWER_API_TOKEN=token1 npx sensortower-mcp
+
+  # Run with multiple backup tokens
+  SENSOR_TOWER_API_TOKEN=token1 \\
+  SENSOR_TOWER_API_TOKEN_BACKUP=token2 \\
+  SENSOR_TOWER_API_TOKEN_2=token3 \\
+  npx sensortower-mcp
+
+MCP CONFIGURATION (Cursor/Claude Desktop):
+  {
+    "mcpServers": {
+      "sensortower": {
+        "command": "npx",
+        "args": ["-y", "sensortower-mcp"],
+        "env": {
+          "SENSOR_TOWER_API_TOKEN": "primary_token",
+          "SENSOR_TOWER_API_TOKEN_BACKUP": "backup_token"
+        }
+      }
+    }
+  }
+
+For more information: https://github.com/sensortower/sensortower-mcp
+`);
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+/**
+ * Sensor Tower MCP Server - Main entry point
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;GAEG"}

package/dist/index.js

@@ -0,0 +1,88 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * Sensor Tower MCP Server - Main entry point
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const index_js_1 = require("@modelcontextprotocol/sdk/server/index.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
+const config_1 = require("./config");
+const client_1 = require("./client");
+const tools_1 = require("./tools");
+async function main() {
+    const config = (0, config_1.parseArgs)();
+    console.error('🚀 Starting Sensor Tower MCP Server...');
+    console.error(`📡 Transport: ${config.transport}`);
+    console.error(`🔑 API Tokens configured: ${config.tokens.length} (auto-failover enabled)`);
+    // Create API client with all tokens
+    const client = new client_1.SensorTowerClient(config.tokens);
+    // Register all tools
+    const allTools = {
+        ...(0, tools_1.registerAppAnalysisTools)(client),
+        ...(0, tools_1.registerSearchTools)(client),
+        ...(0, tools_1.registerUtilityTools)(),
+        ...(0, tools_1.registerMarketAnalysisTools)(client),
+        ...(0, tools_1.registerStoreMarketingTools)(client),
+        ...(0, tools_1.registerYourMetricsTools)(client),
+    };
+    // Create MCP server
+    const server = new index_js_1.Server({
+        name: 'sensortower-mcp',
+        version: '1.2.10',
+    }, {
+        capabilities: {
+            tools: {},
+        },
+    });
+    // Handle list tools request
+    server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => {
+        return {
+            tools: Object.entries(allTools).map(([name, tool]) => ({
+                name,
+                description: tool.description,
+                inputSchema: tool.inputSchema,
+            })),
+        };
+    });
+    // Handle call tool request
+    server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
+        const { name, arguments: args } = request.params;
+        const tool = allTools[name];
+        if (!tool) {
+            throw new Error(`Unknown tool: ${name}`);
+        }
+        try {
+            const result = await tool.handler(args || {});
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify(result, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error: ${message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    // Start server with stdio transport
+    const transport = new stdio_js_1.StdioServerTransport();
+    await server.connect(transport);
+    console.error('Sensor Tower MCP Server running on stdio');
+}
+main().catch((error) => {
+    console.error('Fatal error:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}