sensor-tower-mcp 1.0.0

package/README.md

@@ -0,0 +1,128 @@
+# sensor-tower-mcp
+
+MCP (Model Context Protocol) server for SensorTower API - App Intelligence, Downloads, Revenue, Active Users, and more.
+
+## Installation
+
+```bash
+npx sensor-tower-mcp
+```
+
+## Configuration
+
+Add to your MCP client configuration (e.g., Claude Desktop):
+
+```json
+{
+  "mcpServers": {
+    "sensor-tower-mcp": {
+      "command": "npx",
+      "args": ["-y", "sensor-tower-mcp"],
+      "env": {
+        "SENSOR_TOWER_AUTH_TOKEN": "your_auth_token_here"
+      }
+    }
+  }
+}
+```
+
+## Available Tools
+
+### App Discovery
+- **discover_app_id** - Parse App Store/Google Play URL to extract app ID, or get instructions for finding app ID by name
+
+### App Intelligence
+- **get_app_info** - Get app metadata (name, publisher, categories, ratings, etc.)
+- **get_top_in_app_purchases** - Get top in-app purchases for iOS apps
+
+### Downloads & Revenue
+- **get_sales_report** - Get download and revenue estimates by country and date
+- **get_downloads_by_source** - Get downloads breakdown by source (organic, paid, browser)
+
+### User Metrics
+- **get_active_users** - Get active user estimates (DAU/WAU/MAU)
+- **get_retention** - Get app retention data (Day 1 to Day 90)
+
+### Category Rankings
+- **get_category_ranking_history** - Get historical category ranking
+- **get_category_ranking_summary** - Get current category ranking summary
+
+### Advertising Intelligence
+- **get_ad_network_analysis** - Get advertising share of voice (SOV) time series
+- **get_ad_network_rank** - Get advertising rank across networks and countries
+
+### Reference
+- **list_categories** - List available iOS category IDs
+- **list_ad_networks** - List available ad networks
+
+## Prompts
+
+### analyze_app
+Comprehensive app analysis workflow - automatically finds app ID and retrieves key metrics.
+
+```
+Arguments:
+- app_name_or_url: App name, App Store URL, or Google Play URL
+- platform: ios or android (required if providing app name)
+```
+
+### compare_apps
+Compare multiple apps on key metrics.
+
+```
+Arguments:
+- apps: Comma-separated list of app names or IDs
+- platform: ios or android
+```
+
+## App ID Discovery
+
+The server supports intelligent App ID discovery:
+
+1. **From URLs**: Automatically extracts IDs from App Store or Google Play URLs
+   - iOS: `https://apps.apple.com/.../id284882215` → `284882215`
+   - Android: `https://play.google.com/store/apps/details?id=com.example.app` → `com.example.app`
+
+2. **From Names**: Provides search queries to find official store pages
+   - Use web search (DuckDuckGo, Tavily, etc.) to find the store URL
+   - Extract the App ID from the URL
+
+## Examples
+
+### Get app info
+```
+Use get_app_info with:
+- os: "ios"
+- app_ids: ["284882215"]
+- country: "US"
+```
+
+### Get active users (DAU)
+```
+Use get_active_users with:
+- os: "ios"
+- app_ids: ["284882215"]
+- time_period: "day"
+- start_date: "2024-01-01"
+- end_date: "2024-01-31"
+- countries: ["US"]
+```
+
+### Get sales report
+```
+Use get_sales_report with:
+- os: "ios"
+- app_ids: ["284882215"]
+- date_granularity: "daily"
+- start_date: "2024-01-01"
+- end_date: "2024-01-31"
+- countries: ["US", "GB", "JP"]
+```
+
+## API Rate Limits
+
+SensorTower API has a rate limit of 6 requests per second. The server does not implement rate limiting internally, so be mindful of request frequency.
+
+## License
+
+MIT

package/dist/api-client.d.ts

@@ -0,0 +1,82 @@
+import { SensorTowerConfig, OsType, TimePeriod, DateGranularity, AdIntelPeriod } from './types.js';
+export declare class SensorTowerClient {
+    private authToken;
+    private baseUrl;
+    constructor(config: SensorTowerConfig);
+    private request;
+    getApps(os: 'ios' | 'android', appIds: string[], country?: string): Promise<unknown>;
+    getTopInAppPurchases(appIds: string[], country?: string): Promise<unknown>;
+    getSalesReportEstimates(os: OsType, options: {
+        appIds?: string[];
+        publisherIds?: string[];
+        unifiedAppIds?: string[];
+        unifiedPublisherIds?: string[];
+        categories?: string[];
+        countries?: string[];
+        dateGranularity: DateGranularity;
+        startDate: string;
+        endDate: string;
+        dataModel?: string;
+    }): Promise<unknown>;
+    getCompactSalesReport(os: 'ios' | 'android', options: {
+        appIds?: string[];
+        publisherIds?: string[];
+        unifiedAppIds?: string[];
+        unifiedPublisherIds?: string[];
+        categories?: string[];
+        countries?: string[];
+        dateGranularity?: DateGranularity;
+        startDate: string;
+        endDate: string;
+        dataModel?: string;
+    }): Promise<unknown>;
+    getActiveUsers(os: OsType, options: {
+        appIds: string[];
+        timePeriod: TimePeriod;
+        startDate: string;
+        endDate: string;
+        countries?: string[];
+        dataModel?: string;
+    }): Promise<unknown>;
+    getCategoryHistory(os: 'ios' | 'android', options: {
+        appIds: string[];
+        category: string;
+        chartTypeIds: string[];
+        countries?: string[];
+        startDate: string;
+        endDate: string;
+        isHourly?: boolean;
+    }): Promise<unknown>;
+    getCategoryRankingSummary(os: 'ios' | 'android', appId: string, country?: string): Promise<unknown>;
+    getNetworkAnalysis(os: OsType, options: {
+        appIds: string[];
+        startDate: string;
+        endDate: string;
+        period: AdIntelPeriod;
+        networks?: string[];
+        countries?: string[];
+    }): Promise<unknown>;
+    getNetworkAnalysisRank(os: OsType, options: {
+        appIds: string[];
+        startDate: string;
+        endDate: string;
+        period: 'day' | 'week';
+        networks?: string[];
+        countries?: string[];
+    }): Promise<unknown>;
+    getRetention(os: 'ios' | 'android', options: {
+        appIds: string[];
+        dateGranularity: 'all_time' | 'quarterly';
+        startDate: string;
+        endDate?: string;
+        country?: string;
+    }): Promise<unknown>;
+    getDownloadsBySources(os: OsType, options: {
+        appIds: string[];
+        countries: string[];
+        dateGranularity?: 'daily' | 'monthly';
+        startDate: string;
+        endDate: string;
+    }): Promise<unknown>;
+}
+//# sourceMappingURL=api-client.d.ts.map

package/dist/api-client.d.ts.map

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

package/dist/api-client.js

@@ -0,0 +1,137 @@
+const DEFAULT_BASE_URL = 'https://api.sensortower.com';
+export class SensorTowerClient {
+    authToken;
+    baseUrl;
+    constructor(config) {
+        this.authToken = config.authToken;
+        this.baseUrl = config.baseUrl || DEFAULT_BASE_URL;
+    }
+    async request(endpoint, params) {
+        const url = new URL(endpoint, this.baseUrl);
+        url.searchParams.set('auth_token', this.authToken);
+        for (const [key, value] of Object.entries(params)) {
+            if (value === undefined)
+                continue;
+            if (Array.isArray(value)) {
+                value.forEach(v => url.searchParams.append(`${key}[]`, v));
+            }
+            else {
+                url.searchParams.set(key, value);
+            }
+        }
+        const response = await fetch(url.toString(), {
+            headers: { 'Accept': 'application/json' }
+        });
+        if (!response.ok) {
+            const errorBody = await response.text();
+            throw new Error(`SensorTower API error (${response.status}): ${errorBody}`);
+        }
+        return response.json();
+    }
+    async getApps(os, appIds, country) {
+        return this.request(`/v1/${os}/apps`, {
+            app_ids: appIds,
+            country
+        });
+    }
+    async getTopInAppPurchases(appIds, country) {
+        return this.request('/v1/ios/apps/top_in_app_purchases', {
+            app_ids: appIds,
+            country
+        });
+    }
+    async getSalesReportEstimates(os, options) {
+        return this.request(`/v1/${os}/sales_report_estimates`, {
+            app_ids: options.appIds,
+            publisher_ids: options.publisherIds,
+            unified_app_ids: options.unifiedAppIds,
+            unified_publisher_ids: options.unifiedPublisherIds,
+            categories: options.categories,
+            countries: options.countries,
+            date_granularity: options.dateGranularity,
+            start_date: options.startDate,
+            end_date: options.endDate,
+            data_model: options.dataModel
+        });
+    }
+    async getCompactSalesReport(os, options) {
+        return this.request(`/v1/${os}/compact_sales_report_estimates`, {
+            app_ids: options.appIds,
+            publisher_ids: options.publisherIds,
+            unified_app_ids: options.unifiedAppIds,
+            unified_publisher_ids: options.unifiedPublisherIds,
+            categories: options.categories,
+            countries: options.countries,
+            date_granularity: options.dateGranularity,
+            start_date: options.startDate,
+            end_date: options.endDate,
+            data_model: options.dataModel
+        });
+    }
+    async getActiveUsers(os, options) {
+        return this.request(`/v1/${os}/usage/active_users`, {
+            app_ids: options.appIds,
+            time_period: options.timePeriod,
+            start_date: options.startDate,
+            end_date: options.endDate,
+            countries: options.countries,
+            data_model: options.dataModel
+        });
+    }
+    async getCategoryHistory(os, options) {
+        return this.request(`/v1/${os}/category/category_history`, {
+            app_ids: options.appIds,
+            category: options.category,
+            chart_type_ids: options.chartTypeIds,
+            countries: options.countries,
+            start_date: options.startDate,
+            end_date: options.endDate,
+            is_hourly: options.isHourly?.toString()
+        });
+    }
+    async getCategoryRankingSummary(os, appId, country) {
+        return this.request(`/v1/${os}/category/category_ranking_summary`, {
+            app_id: appId,
+            country
+        });
+    }
+    async getNetworkAnalysis(os, options) {
+        return this.request(`/v1/${os}/ad_intel/network_analysis`, {
+            app_ids: options.appIds,
+            start_date: options.startDate,
+            end_date: options.endDate,
+            period: options.period,
+            networks: options.networks,
+            countries: options.countries
+        });
+    }
+    async getNetworkAnalysisRank(os, options) {
+        return this.request(`/v1/${os}/ad_intel/network_analysis/rank`, {
+            app_ids: options.appIds,
+            start_date: options.startDate,
+            end_date: options.endDate,
+            period: options.period,
+            networks: options.networks,
+            countries: options.countries
+        });
+    }
+    async getRetention(os, options) {
+        return this.request(`/v1/${os}/usage/retention`, {
+            app_ids: options.appIds,
+            date_granularity: options.dateGranularity,
+            start_date: options.startDate,
+            end_date: options.endDate,
+            country: options.country
+        });
+    }
+    async getDownloadsBySources(os, options) {
+        return this.request(`/v1/${os}/downloads_by_sources`, {
+            app_ids: options.appIds,
+            countries: options.countries,
+            date_granularity: options.dateGranularity,
+            start_date: options.startDate,
+            end_date: options.endDate
+        });
+    }
+}
+//# sourceMappingURL=api-client.js.map

package/dist/api-client.js.map

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

package/dist/app-discovery.d.ts

@@ -0,0 +1,13 @@
+import { AppIdDiscoveryResult } from './types.js';
+export declare function parseAppStoreUrl(url: string): AppIdDiscoveryResult | null;
+export declare function extractAppIdFromText(text: string): AppIdDiscoveryResult[];
+export declare function generateSearchQuery(appName: string, platform: 'ios' | 'android'): string;
+export declare function parseSearchResultsForAppId(searchResults: string, platform: 'ios' | 'android'): AppIdDiscoveryResult | null;
+export interface AppIdentifier {
+    type: 'app_id' | 'app_name' | 'store_url';
+    value: string;
+    platform?: 'ios' | 'android';
+}
+export declare function identifyAppInput(input: string): AppIdentifier;
+export declare function createAppDiscoveryInstructions(appName: string): string;
+//# sourceMappingURL=app-discovery.d.ts.map

package/dist/app-discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-discovery.d.ts","sourceRoot":"","sources":["../src/app-discovery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAElD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,oBAAoB,GAAG,IAAI,CAsCzE;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,oBAAoB,EAAE,CAczE;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,GAAG,SAAS,GAAG,MAAM,CAMxF;AAED,wBAAgB,0BAA0B,CACxC,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,KAAK,GAAG,SAAS,GAC1B,oBAAoB,GAAG,IAAI,CAwB7B;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,QAAQ,GAAG,UAAU,GAAG,WAAW,CAAC;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,KAAK,GAAG,SAAS,CAAC;CAC9B;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,CAkB7D;AAED,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAYtE"}

package/dist/app-discovery.js

@@ -0,0 +1,107 @@
+export function parseAppStoreUrl(url) {
+    const iosPattern = /apps\.apple\.com\/.*\/app\/.*\/id(\d+)/i;
+    const iosMatch = url.match(iosPattern);
+    if (iosMatch) {
+        return {
+            platform: 'ios',
+            app_id: iosMatch[1],
+            store_url: url,
+            source: 'url_parse'
+        };
+    }
+    const iosAltPattern = /itunes\.apple\.com\/.*\/app\/.*\/id(\d+)/i;
+    const iosAltMatch = url.match(iosAltPattern);
+    if (iosAltMatch) {
+        return {
+            platform: 'ios',
+            app_id: iosAltMatch[1],
+            store_url: url,
+            source: 'url_parse'
+        };
+    }
+    const androidPattern = /play\.google\.com\/store\/apps\/details\?id=([a-zA-Z0-9._]+)/i;
+    const androidMatch = url.match(androidPattern);
+    if (androidMatch) {
+        return {
+            platform: 'android',
+            app_id: androidMatch[1],
+            store_url: url,
+            source: 'url_parse'
+        };
+    }
+    return null;
+}
+export function extractAppIdFromText(text) {
+    const results = [];
+    const urlPattern = /(https?:\/\/[^\s]+)/gi;
+    const urls = text.match(urlPattern) || [];
+    for (const url of urls) {
+        const result = parseAppStoreUrl(url);
+        if (result) {
+            results.push(result);
+        }
+    }
+    return results;
+}
+export function generateSearchQuery(appName, platform) {
+    if (platform === 'ios') {
+        return `${appName} site:apps.apple.com app store`;
+    }
+    else {
+        return `${appName} site:play.google.com google play store`;
+    }
+}
+export function parseSearchResultsForAppId(searchResults, platform) {
+    if (platform === 'ios') {
+        const pattern = /apps\.apple\.com\/[a-z]{2}\/app\/[^\/]+\/id(\d+)/i;
+        const match = searchResults.match(pattern);
+        if (match) {
+            return {
+                platform: 'ios',
+                app_id: match[1],
+                source: 'search'
+            };
+        }
+    }
+    else {
+        const pattern = /play\.google\.com\/store\/apps\/details\?id=([a-zA-Z0-9._]+)/i;
+        const match = searchResults.match(pattern);
+        if (match) {
+            return {
+                platform: 'android',
+                app_id: match[1],
+                source: 'search'
+            };
+        }
+    }
+    return null;
+}
+export function identifyAppInput(input) {
+    if (input.includes('apps.apple.com') || input.includes('itunes.apple.com')) {
+        return { type: 'store_url', value: input, platform: 'ios' };
+    }
+    if (input.includes('play.google.com')) {
+        return { type: 'store_url', value: input, platform: 'android' };
+    }
+    if (/^\d+$/.test(input)) {
+        return { type: 'app_id', value: input, platform: 'ios' };
+    }
+    if (/^[a-z][a-z0-9_]*(\.[a-z][a-z0-9_]*)+$/i.test(input)) {
+        return { type: 'app_id', value: input, platform: 'android' };
+    }
+    return { type: 'app_name', value: input };
+}
+export function createAppDiscoveryInstructions(appName) {
+    return `To find the App ID for "${appName}", please:
+
+1. **For iOS apps**: Search for "${appName} site:apps.apple.com" and extract the numeric ID from the URL
+   - URL format: https://apps.apple.com/.../id[NUMERIC_ID]
+   - Example: https://apps.apple.com/us/app/facebook/id284882215 → App ID: 284882215
+
+2. **For Android apps**: Search for "${appName} site:play.google.com" and extract the package name
+   - URL format: https://play.google.com/store/apps/details?id=[PACKAGE_NAME]
+   - Example: https://play.google.com/store/apps/details?id=com.facebook.katana → App ID: com.facebook.katana
+
+Once you have the App ID, you can use it with the SensorTower API tools.`;
+}
+//# sourceMappingURL=app-discovery.js.map

package/dist/app-discovery.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+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":""}

package/dist/index.js

@@ -0,0 +1,512 @@
+#!/usr/bin/env node
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, ListPromptsRequestSchema, GetPromptRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { SensorTowerClient } from './api-client.js';
+import { parseAppStoreUrl, identifyAppInput, createAppDiscoveryInstructions, generateSearchQuery, } from './app-discovery.js';
+import { AD_NETWORKS, IOS_CATEGORIES, CHART_TYPES } from './types.js';
+const SERVER_NAME = 'sensor-tower-mcp';
+const SERVER_VERSION = '1.0.0';
+let client = null;
+function getClient() {
+    if (!client) {
+        const authToken = process.env.SENSOR_TOWER_AUTH_TOKEN;
+        if (!authToken) {
+            throw new Error('SENSOR_TOWER_AUTH_TOKEN environment variable is required. ' +
+                'Please set it in your MCP server configuration.');
+        }
+        client = new SensorTowerClient({ authToken });
+    }
+    return client;
+}
+const server = new Server({ name: SERVER_NAME, version: SERVER_VERSION }, { capabilities: { tools: {}, prompts: {} } });
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+    return {
+        tools: [
+            {
+                name: 'discover_app_id',
+                description: 'Parse App Store or Google Play URL to extract app ID, or provide instructions for finding app ID by name',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        input: {
+                            type: 'string',
+                            description: 'App Store URL, Google Play URL, or app name to discover'
+                        },
+                        platform: {
+                            type: 'string',
+                            enum: ['ios', 'android'],
+                            description: 'Target platform (required if input is app name)'
+                        }
+                    },
+                    required: ['input']
+                }
+            },
+            {
+                name: 'get_app_info',
+                description: 'Get app metadata including name, publisher, categories, ratings, and more',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        os: { type: 'string', enum: ['ios', 'android'], description: 'Operating system' },
+                        app_ids: { type: 'array', items: { type: 'string' }, description: 'App IDs (max 100)' },
+                        country: { type: 'string', description: 'Country code (default: US)' }
+                    },
+                    required: ['os', 'app_ids']
+                }
+            },
+            {
+                name: 'get_top_in_app_purchases',
+                description: 'Get top in-app purchases for iOS apps',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        app_ids: { type: 'array', items: { type: 'string' }, description: 'iOS App IDs' },
+                        country: { type: 'string', description: 'Country code' }
+                    },
+                    required: ['app_ids']
+                }
+            },
+            {
+                name: 'get_sales_report',
+                description: 'Get download and revenue estimates for apps by country and date',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        os: { type: 'string', enum: ['ios', 'android', 'unified'], description: 'Operating system' },
+                        app_ids: { type: 'array', items: { type: 'string' }, description: 'App IDs' },
+                        countries: { type: 'array', items: { type: 'string' }, description: 'Country codes (WW for worldwide)' },
+                        date_granularity: { type: 'string', enum: ['daily', 'weekly', 'monthly', 'quarterly'], description: 'Date granularity' },
+                        start_date: { type: 'string', description: 'Start date (YYYY-MM-DD)' },
+                        end_date: { type: 'string', description: 'End date (YYYY-MM-DD)' }
+                    },
+                    required: ['os', 'app_ids', 'date_granularity', 'start_date', 'end_date']
+                }
+            },
+            {
+                name: 'get_active_users',
+                description: 'Get active user estimates (DAU/WAU/MAU) for apps',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        os: { type: 'string', enum: ['ios', 'android', 'unified'], description: 'Operating system' },
+                        app_ids: { type: 'array', items: { type: 'string' }, description: 'App IDs (max 500)' },
+                        time_period: { type: 'string', enum: ['day', 'week', 'month'], description: 'Time period: day=DAU, week=WAU, month=MAU' },
+                        start_date: { type: 'string', description: 'Start date (YYYY-MM-DD)' },
+                        end_date: { type: 'string', description: 'End date (YYYY-MM-DD)' },
+                        countries: { type: 'array', items: { type: 'string' }, description: 'Country codes' }
+                    },
+                    required: ['os', 'app_ids', 'time_period', 'start_date', 'end_date']
+                }
+            },
+            {
+                name: 'get_category_ranking_history',
+                description: 'Get historical category ranking for apps',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        os: { type: 'string', enum: ['ios', 'android'], description: 'Operating system' },
+                        app_ids: { type: 'array', items: { type: 'string' }, description: 'App IDs' },
+                        category: { type: 'string', description: 'Category ID (e.g., 6005 for Social Networking)' },
+                        chart_type_ids: { type: 'array', items: { type: 'string' }, description: 'Chart type IDs: 0=free, 1=paid, 2=grossing' },
+                        countries: { type: 'array', items: { type: 'string' }, description: 'Country codes' },
+                        start_date: { type: 'string', description: 'Start date (YYYY-MM-DD)' },
+                        end_date: { type: 'string', description: 'End date (YYYY-MM-DD)' }
+                    },
+                    required: ['os', 'app_ids', 'category', 'chart_type_ids', 'start_date', 'end_date']
+                }
+            },
+            {
+                name: 'get_category_ranking_summary',
+                description: 'Get current category ranking summary for an app',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        os: { type: 'string', enum: ['ios', 'android'], description: 'Operating system' },
+                        app_id: { type: 'string', description: 'Single App ID' },
+                        country: { type: 'string', description: 'Country code' }
+                    },
+                    required: ['os', 'app_id']
+                }
+            },
+            {
+                name: 'get_ad_network_analysis',
+                description: 'Get advertising share of voice (SOV) time series for apps',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        os: { type: 'string', enum: ['ios', 'android', 'unified'], description: 'Operating system' },
+                        app_ids: { type: 'array', items: { type: 'string' }, description: 'App IDs' },
+                        start_date: { type: 'string', description: 'Start date (YYYY-MM-DD), min: 2018-01-01' },
+                        end_date: { type: 'string', description: 'End date (YYYY-MM-DD)' },
+                        period: { type: 'string', enum: ['day', 'week', 'month'], description: 'Time period' },
+                        networks: { type: 'array', items: { type: 'string' }, description: 'Ad networks (e.g., Facebook, Admob, Unity)' },
+                        countries: { type: 'array', items: { type: 'string' }, description: 'Country codes' }
+                    },
+                    required: ['os', 'app_ids', 'start_date', 'end_date', 'period']
+                }
+            },
+            {
+                name: 'get_ad_network_rank',
+                description: 'Get advertising rank for apps across networks and countries',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        os: { type: 'string', enum: ['ios', 'android', 'unified'], description: 'Operating system' },
+                        app_ids: { type: 'array', items: { type: 'string' }, description: 'App IDs' },
+                        start_date: { type: 'string', description: 'Start date (YYYY-MM-DD)' },
+                        end_date: { type: 'string', description: 'End date (YYYY-MM-DD)' },
+                        period: { type: 'string', enum: ['day', 'week'], description: 'Time period (day or week only)' },
+                        networks: { type: 'array', items: { type: 'string' }, description: 'Ad networks' },
+                        countries: { type: 'array', items: { type: 'string' }, description: 'Country codes' }
+                    },
+                    required: ['os', 'app_ids', 'start_date', 'end_date', 'period']
+                }
+            },
+            {
+                name: 'get_retention',
+                description: 'Get app retention data (Day 1 to Day 90)',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        os: { type: 'string', enum: ['ios', 'android'], description: 'Operating system' },
+                        app_ids: { type: 'array', items: { type: 'string' }, description: 'App IDs' },
+                        date_granularity: { type: 'string', enum: ['all_time', 'quarterly'], description: 'Date granularity' },
+                        start_date: { type: 'string', description: 'Start date (YYYY-MM-DD)' },
+                        end_date: { type: 'string', description: 'End date (YYYY-MM-DD), ignored for all_time' },
+                        country: { type: 'string', description: 'Country code (default: WW)' }
+                    },
+                    required: ['os', 'app_ids', 'date_granularity', 'start_date']
+                }
+            },
+            {
+                name: 'get_downloads_by_source',
+                description: 'Get downloads breakdown by source (organic, paid, browser)',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        os: { type: 'string', enum: ['ios', 'android', 'unified'], description: 'Operating system' },
+                        app_ids: { type: 'array', items: { type: 'string' }, description: 'Unified App IDs' },
+                        countries: { type: 'array', items: { type: 'string' }, description: 'Country codes (WW for worldwide)' },
+                        date_granularity: { type: 'string', enum: ['daily', 'monthly'], description: 'Date granularity' },
+                        start_date: { type: 'string', description: 'Start date (YYYY-MM-DD)' },
+                        end_date: { type: 'string', description: 'End date (YYYY-MM-DD)' }
+                    },
+                    required: ['os', 'app_ids', 'countries', 'start_date', 'end_date']
+                }
+            },
+            {
+                name: 'list_categories',
+                description: 'List available iOS category IDs',
+                inputSchema: {
+                    type: 'object',
+                    properties: {}
+                }
+            },
+            {
+                name: 'list_ad_networks',
+                description: 'List available ad networks for network analysis',
+                inputSchema: {
+                    type: 'object',
+                    properties: {}
+                }
+            }
+        ]
+    };
+});
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    try {
+        switch (name) {
+            case 'discover_app_id': {
+                const input = args?.input;
+                const platform = args?.platform;
+                const identified = identifyAppInput(input);
+                if (identified.type === 'store_url') {
+                    const result = parseAppStoreUrl(input);
+                    if (result) {
+                        return {
+                            content: [{
+                                    type: 'text',
+                                    text: JSON.stringify({
+                                        success: true,
+                                        platform: result.platform,
+                                        app_id: result.app_id,
+                                        source: 'url_parse'
+                                    }, null, 2)
+                                }]
+                        };
+                    }
+                }
+                if (identified.type === 'app_id') {
+                    return {
+                        content: [{
+                                type: 'text',
+                                text: JSON.stringify({
+                                    success: true,
+                                    platform: identified.platform,
+                                    app_id: identified.value,
+                                    source: 'direct_id'
+                                }, null, 2)
+                            }]
+                    };
+                }
+                const targetPlatform = platform || 'ios';
+                const searchQuery = generateSearchQuery(input, targetPlatform);
+                const instructions = createAppDiscoveryInstructions(input);
+                return {
+                    content: [{
+                            type: 'text',
+                            text: JSON.stringify({
+                                success: false,
+                                app_name: input,
+                                platform: targetPlatform,
+                                search_query: searchQuery,
+                                instructions: instructions,
+                                note: 'Use web search with the provided query to find the app store URL, then extract the App ID'
+                            }, null, 2)
+                        }]
+                };
+            }
+            case 'get_app_info': {
+                const apiClient = getClient();
+                const result = await apiClient.getApps(args?.os, args?.app_ids, args?.country);
+                return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+            }
+            case 'get_top_in_app_purchases': {
+                const apiClient = getClient();
+                const result = await apiClient.getTopInAppPurchases(args?.app_ids, args?.country);
+                return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+            }
+            case 'get_sales_report': {
+                const apiClient = getClient();
+                const result = await apiClient.getSalesReportEstimates(args?.os, {
+                    appIds: args?.app_ids,
+                    countries: args?.countries,
+                    dateGranularity: args?.date_granularity,
+                    startDate: args?.start_date,
+                    endDate: args?.end_date
+                });
+                return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+            }
+            case 'get_active_users': {
+                const apiClient = getClient();
+                const result = await apiClient.getActiveUsers(args?.os, {
+                    appIds: args?.app_ids,
+                    timePeriod: args?.time_period,
+                    startDate: args?.start_date,
+                    endDate: args?.end_date,
+                    countries: args?.countries
+                });
+                return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+            }
+            case 'get_category_ranking_history': {
+                const apiClient = getClient();
+                const result = await apiClient.getCategoryHistory(args?.os, {
+                    appIds: args?.app_ids,
+                    category: args?.category,
+                    chartTypeIds: args?.chart_type_ids,
+                    countries: args?.countries,
+                    startDate: args?.start_date,
+                    endDate: args?.end_date
+                });
+                return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+            }
+            case 'get_category_ranking_summary': {
+                const apiClient = getClient();
+                const result = await apiClient.getCategoryRankingSummary(args?.os, args?.app_id, args?.country);
+                return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+            }
+            case 'get_ad_network_analysis': {
+                const apiClient = getClient();
+                const result = await apiClient.getNetworkAnalysis(args?.os, {
+                    appIds: args?.app_ids,
+                    startDate: args?.start_date,
+                    endDate: args?.end_date,
+                    period: args?.period,
+                    networks: args?.networks,
+                    countries: args?.countries
+                });
+                return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+            }
+            case 'get_ad_network_rank': {
+                const apiClient = getClient();
+                const result = await apiClient.getNetworkAnalysisRank(args?.os, {
+                    appIds: args?.app_ids,
+                    startDate: args?.start_date,
+                    endDate: args?.end_date,
+                    period: args?.period,
+                    networks: args?.networks,
+                    countries: args?.countries
+                });
+                return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+            }
+            case 'get_retention': {
+                const apiClient = getClient();
+                const result = await apiClient.getRetention(args?.os, {
+                    appIds: args?.app_ids,
+                    dateGranularity: args?.date_granularity,
+                    startDate: args?.start_date,
+                    endDate: args?.end_date,
+                    country: args?.country
+                });
+                return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+            }
+            case 'get_downloads_by_source': {
+                const apiClient = getClient();
+                const result = await apiClient.getDownloadsBySources(args?.os, {
+                    appIds: args?.app_ids,
+                    countries: args?.countries,
+                    dateGranularity: args?.date_granularity,
+                    startDate: args?.start_date,
+                    endDate: args?.end_date
+                });
+                return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+            }
+            case 'list_categories': {
+                return {
+                    content: [{
+                            type: 'text',
+                            text: JSON.stringify({
+                                ios_categories: IOS_CATEGORIES,
+                                chart_types: CHART_TYPES,
+                                note: 'For full category list, see: https://app.sensortower.com/api/docs/static/category_ids.json'
+                            }, null, 2)
+                        }]
+                };
+            }
+            case 'list_ad_networks': {
+                return {
+                    content: [{
+                            type: 'text',
+                            text: JSON.stringify({
+                                networks: AD_NETWORKS,
+                                note: 'Use these network names in the get_ad_network_analysis and get_ad_network_rank tools'
+                            }, null, 2)
+                        }]
+                };
+            }
+            default:
+                throw new Error(`Unknown tool: ${name}`);
+        }
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return {
+            content: [{ type: 'text', text: `Error: ${errorMessage}` }],
+            isError: true
+        };
+    }
+});
+server.setRequestHandler(ListPromptsRequestSchema, async () => {
+    return {
+        prompts: [
+            {
+                name: 'analyze_app',
+                description: 'Comprehensive app analysis workflow - finds app ID and retrieves key metrics',
+                arguments: [
+                    { name: 'app_name_or_url', description: 'App name, App Store URL, or Google Play URL', required: true },
+                    { name: 'platform', description: 'ios or android (required if providing app name)', required: false }
+                ]
+            },
+            {
+                name: 'compare_apps',
+                description: 'Compare multiple apps on key metrics',
+                arguments: [
+                    { name: 'apps', description: 'Comma-separated list of app names or IDs', required: true },
+                    { name: 'platform', description: 'ios or android', required: true }
+                ]
+            }
+        ]
+    };
+});
+server.setRequestHandler(GetPromptRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    switch (name) {
+        case 'analyze_app': {
+            const appInput = args?.app_name_or_url || '';
+            const platform = args?.platform || 'ios';
+            return {
+                messages: [
+                    {
+                        role: 'user',
+                        content: {
+                            type: 'text',
+                            text: `Please analyze the app: "${appInput}" on ${platform} platform.
+
+## Workflow:
+
+1. **App ID Discovery**:
+   - If a URL is provided, extract the App ID directly
+   - If only a name is provided, search for the official store page:
+     • iOS: Search "${appInput} site:apps.apple.com" → extract ID from /id[NUMBER]
+     • Android: Search "${appInput} site:play.google.com" → extract package name from ?id=[PACKAGE]
+
+2. **Once App ID is found, retrieve**:
+   - Basic app info (get_app_info)
+   - Current category rankings (get_category_ranking_summary)
+   - Recent downloads and revenue (get_sales_report) - last 30 days
+   - Active users if available (get_active_users) - last 30 days
+
+3. **Provide a summary** including:
+   - App name, publisher, category
+   - Current rankings
+   - Download/revenue trends
+   - User engagement metrics
+
+If App ID cannot be found, clearly note this limitation and proceed with available information.`
+                        }
+                    }
+                ]
+            };
+        }
+        case 'compare_apps': {
+            const apps = args?.apps || '';
+            const platform = args?.platform || 'ios';
+            return {
+                messages: [
+                    {
+                        role: 'user',
+                        content: {
+                            type: 'text',
+                            text: `Please compare these apps: ${apps} on ${platform} platform.
+
+## Workflow:
+
+1. **For each app**, discover the App ID (from URL or search)
+
+2. **Retrieve comparative metrics**:
+   - Basic app info for all apps
+   - Downloads and revenue (last 30 days)
+   - Category rankings
+   - Active users if available
+
+3. **Create a comparison table** showing:
+   - App name and publisher
+   - Category and rankings
+   - Downloads and revenue
+   - User engagement
+
+4. **Provide insights** on:
+   - Market position of each app
+   - Relative strengths and weaknesses
+   - Growth trends`
+                        }
+                    }
+                ]
+            };
+        }
+        default:
+            throw new Error(`Unknown prompt: ${name}`);
+    }
+});
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error(`${SERVER_NAME} v${SERVER_VERSION} 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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"}

package/dist/types.d.ts

@@ -0,0 +1,81 @@
+export interface SensorTowerConfig {
+    authToken: string;
+    baseUrl?: string;
+}
+export type OsType = 'ios' | 'android' | 'unified';
+export type TimePeriod = 'day' | 'week' | 'month';
+export type DateGranularity = 'daily' | 'weekly' | 'monthly' | 'quarterly' | 'all_time';
+export type AdIntelPeriod = 'day' | 'week' | 'month';
+export interface AppInfo {
+    app_id: string | number;
+    name: string;
+    publisher_name: string;
+    os: OsType;
+    unified_app_id?: string;
+    bundle_id?: string;
+    categories?: number[];
+    icon_url?: string;
+    rating?: number;
+    price?: number;
+}
+export interface ActiveUsersData {
+    app_id: string | number;
+    country: string;
+    date: string;
+    ipad_users?: number;
+    iphone_users?: number;
+    users?: number;
+}
+export interface SalesReportData {
+    app_id: string | number;
+    country: string;
+    date: string;
+    downloads?: number;
+    revenue?: number;
+}
+export interface CategoryRankingData {
+    app_id: string | number;
+    country: string;
+    category: string;
+    chart_type: string;
+    rank: number;
+    date: string;
+}
+export interface RetentionData {
+    app_id: string | number;
+    country: string;
+    date_granularity: string;
+    date: string;
+    corrected_retention: number[];
+    confidence?: number;
+}
+export interface NetworkAnalysisData {
+    app_id: string;
+    country: string;
+    network: string;
+    date: string;
+    sov: number;
+}
+export interface DownloadsBySourceData {
+    app_id: string;
+    breakdown: {
+        date: string;
+        organic_abs: number;
+        paid_abs: number;
+        browser_abs: number;
+        organic_frac: number;
+        paid_frac: number;
+        browser_frac: number;
+    }[];
+}
+export interface AppIdDiscoveryResult {
+    platform: 'ios' | 'android';
+    app_id: string;
+    app_name?: string;
+    store_url?: string;
+    source: 'url_parse' | 'search';
+}
+export declare const AD_NETWORKS: readonly ["Adcolony", "Admob", "Applovin", "BidMachine", "Chartboost", "Digital Turbine", "Facebook", "InMobi", "Instagram", "Line", "Meta Audience Network", "Mintegral", "Moloco", "Mopub", "Pangle", "Pinterest", "Smaato", "Snapchat", "Supersonic", "Tapjoy", "TikTok", "Twitter", "Unity", "Verve", "Vungle", "Youtube"];
+export declare const IOS_CATEGORIES: Record<string, string>;
+export declare const CHART_TYPES: Record<string, string>;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,35 @@
+export const AD_NETWORKS = [
+    'Adcolony', 'Admob', 'Applovin', 'BidMachine', 'Chartboost',
+    'Digital Turbine', 'Facebook', 'InMobi', 'Instagram', 'Line',
+    'Meta Audience Network', 'Mintegral', 'Moloco', 'Mopub', 'Pangle',
+    'Pinterest', 'Smaato', 'Snapchat', 'Supersonic', 'Tapjoy',
+    'TikTok', 'Twitter', 'Unity', 'Verve', 'Vungle', 'Youtube'
+];
+export const IOS_CATEGORIES = {
+    'social_networking': '6005',
+    'games': '6014',
+    'entertainment': '6016',
+    'photo_video': '6008',
+    'music': '6011',
+    'shopping': '6024',
+    'finance': '6015',
+    'health_fitness': '6013',
+    'productivity': '6007',
+    'news': '6009',
+    'education': '6017',
+    'lifestyle': '6012',
+    'utilities': '6002',
+    'travel': '6003',
+    'sports': '6004',
+    'food_drink': '6023',
+    'business': '6000',
+    'weather': '6001',
+    'reference': '6006',
+    'navigation': '6010'
+};
+export const CHART_TYPES = {
+    'free': '0',
+    'paid': '1',
+    'grossing': '2'
+};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAuFA,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,UAAU,EAAE,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,YAAY;IAC3D,iBAAiB,EAAE,UAAU,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM;IAC5D,uBAAuB,EAAE,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ;IACjE,WAAW,EAAE,QAAQ,EAAE,UAAU,EAAE,YAAY,EAAE,QAAQ;IACzD,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS;CAClD,CAAC;AAEX,MAAM,CAAC,MAAM,cAAc,GAA2B;IACpD,mBAAmB,EAAE,MAAM;IAC3B,OAAO,EAAE,MAAM;IACf,eAAe,EAAE,MAAM;IACvB,aAAa,EAAE,MAAM;IACrB,OAAO,EAAE,MAAM;IACf,UAAU,EAAE,MAAM;IAClB,SAAS,EAAE,MAAM;IACjB,gBAAgB,EAAE,MAAM;IACxB,cAAc,EAAE,MAAM;IACtB,MAAM,EAAE,MAAM;IACd,WAAW,EAAE,MAAM;IACnB,WAAW,EAAE,MAAM;IACnB,WAAW,EAAE,MAAM;IACnB,QAAQ,EAAE,MAAM;IAChB,QAAQ,EAAE,MAAM;IAChB,YAAY,EAAE,MAAM;IACpB,UAAU,EAAE,MAAM;IAClB,SAAS,EAAE,MAAM;IACjB,WAAW,EAAE,MAAM;IACnB,YAAY,EAAE,MAAM;CACrB,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAA2B;IACjD,MAAM,EAAE,GAAG;IACX,MAAM,EAAE,GAAG;IACX,UAAU,EAAE,GAAG;CAChB,CAAC"}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "sensor-tower-mcp",
+  "version": "1.0.0",
+  "description": "MCP server for SensorTower API - App Intelligence, Downloads, Revenue, Active Users, and more",
+  "main": "dist/index.js",
+  "type": "module",
+  "bin": {
+    "sensor-tower-mcp": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsc --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "sensortower",
+    "app-intelligence",
+    "mobile-analytics",
+    "app-store",
+    "google-play"
+  ],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "typescript": "^5.3.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "dist"
+  ]
+}