appdatalayer-mcp

Open-source TypeScript SDK for the AppDataLayer MCP Server — the App Intelligence Query Engine powered by the Model Context Protocol.

Analyze 1B+ app reviews across Google Play and the Apple App Store. Semantic topic search, sentiment analysis, keyword rankings, competitive analysis, and time-series forecasting — all through a single typed API.

Installation

npm install appdatalayer-mcp

Quick Start

As a TypeScript/JavaScript SDK

import { AppDataLayerClient } from "appdatalayer-mcp";

const client = new AppDataLayerClient({ apiKey: "sk_live_..." });

// Get app metadata
const app = await client.getAppOverview("com.instagram.android");
console.log(app.data?.title, app.data?.score);

// Analyze review sentiment
const reviews = await client.analyzeReviews({
  app_id: "com.spotify.music",
  dimensions: ["sentiment", "topic"],
  days: 30,
});

// Semantic topic search
const topics = await client.searchTopics("crashes and bugs");

// Compare apps head-to-head
const comparison = await client.compareApps({
  app_ids: ["com.spotify.music", "com.apple.music"],
});

// Forecast review volume
const forecast = await client.forecastMetric({
  series: [100, 120, 115, 130, 128, 145, 142, 160, 155, 170],
  horizon: 7,
});

await client.disconnect();

As an MCP Server for LLM Agents

Use AppDataLayer directly in Claude Desktop, Cursor, Windsurf, or any MCP-compatible AI agent:

import { generateMcpConfig } from "appdatalayer-mcp";

const config = generateMcpConfig("sk_live_...");
console.log(JSON.stringify(config, null, 2));

Paste the output into your agent's config file:

Client	Config File
Claude Desktop	~/Library/Application Support/Claude/claude_desktop_config.json
Cursor	.cursor/mcp.json
Windsurf	~/.windsurf/mcp.json
VS Code	.vscode/mcp.json

Generated config:

{
  "mcpServers": {
    "appdatalayer": {
      "url": "https://mcp.appdatalayer.com/mcp",
      "headers": {
        "APPDATALAYER_API_KEY": "sk_live_..."
      }
    }
  }
}

Available Tools

The SDK provides typed methods for all 22 MCP tools:

Data Querying

Method	Description
getAppOverview(appId)	App metadata: title, developer, score, installs, rating histogram
analyzeReviews(input)	Aggregate reviews by day/week/month/sentiment/country/score/topic
getKeywordRankings(input)	Track app ranking for a search keyword over time
getTopCharts(input?)	Latest top charts (free, paid, grossing, new)
getSimilarApps(appId)	Apps similar/related to a given app
getSearchSuggestions(input)	Autocomplete suggestions from app stores
getGlobalStats()	Platform totals: apps tracked, reviews count
getReviewsByTopics(input)	Actual review text filtered by topic IDs
compareApps(input)	Head-to-head comparison of 2-5 apps
getTopicTrend(input)	Track topic volume and sentiment changes over time

Topic Intelligence

Method	Description
resolveTopics(ids)	Convert topic IDs → human-readable labels
searchTopics(query)	Semantic search over 1M+ review topics
findAppsByTopics(input)	Find apps at the intersection of two topic sets

Forecasting

Method	Description
forecastMetric(input)	Predict future values using Google TimesFM 2.5

Scraping Operations

Method	Description
getScrapeJobsOverview()	Overview of all scraping jobs by type
listScrapeJobs(input?)	List and filter individual scrape jobs
getFailedJobs(input?)	Get failed/dead jobs with failure reasons
getJobScheduleStatus(input?)	Get overdue jobs

Webhooks

Method	Description
listWebhooks()	List all webhooks for the authenticated user
createWebhook(input)	Create a webhook alert rule
deleteWebhook(id)	Delete a webhook
toggleWebhook(id, active)	Enable/disable a webhook

Raw Access

Method	Description
call(toolName, args)	Call any MCP tool by name
listTools()	List all available tools
listResources()	List all available resources
readResource(uri)	Read a resource (e.g. table schemas)

API Reference

AppDataLayerClient

const client = new AppDataLayerClient({
  apiKey: string;            // Required — your API key
  endpoint?: string;         // Default: "https://mcp.appdatalayer.com/mcp"
  timeout?: number;          // Default: 30000ms
});

Return Type

All methods return ToolCallResult<T>:

interface ToolCallResult<T> {
  content: { type: string; text: string }[]; // Raw MCP content
  isError?: boolean;                          // True if the tool returned an error
  data: T | null;                             // Parsed JSON data (null if error)
}

generateMcpConfig

import { generateMcpConfig } from "appdatalayer-mcp";

const config = generateMcpConfig(
  apiKey: string,
  endpoint?: string  // Default: "https://mcp.appdatalayer.com/mcp"
);

Configuration

Env Variable	Description
APPDATALAYER_API_KEY	Your AppDataLayer API key

Examples

See the examples/ directory:

• basic-usage.ts — All major SDK features
• generate-config.ts — Generate LLM agent config

Data Coverage

Metric	Value
Reviews	1B+
Apps	250K+
Topics	1M+ clusters
Countries	44
Stores	Google Play, Apple App Store

License

MIT — AppDataLayer