npm install appdatalayer-mcp

npx appdatalayer-mcp setup

npx appdatalayer-mcp setup --agent cursor
npx appdatalayer-mcp setup --api-key sk_live_...

import { AppDataLayerClient } from "appdatalayer-mcp";

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

// Get weekly report for an app
const report = await client.call("get_weekly_report", { app_id: "com.spotify.music" });

// Ask about your app in natural language (Pro)
const answer = await client.call("ask_about_my_app", {
  app_id: "com.spotify.music",
  question: "Are users complaining about battery drain?",
});

// Query live data — app overview
const app = await client.call("query_live_data", {
  query_type: "app_overview",
  app_id: "com.instagram.android",
});

// Query live data — analyze reviews
const reviews = await client.call("query_live_data", {
  query_type: "analyze_reviews",
  app_id: "com.spotify.music",
  dimensions: ["sentiment", "topic"],
  days: 30,
});

// Query live data — forecast with auto-fetch
const forecast = await client.call("query_live_data", {
  query_type: "forecast",
  metric: "review_count",
  app_id: "com.spotify.music",
  horizon: 7,
});

// Query live data — compare apps
const comparison = await client.call("query_live_data", {
  query_type: "compare_apps",
  app_ids: ["com.spotify.music", "com.apple.music"],
  days: 30,
});

// Manage tracking — track an app
await client.call("manage_tracking", {
  action: "track_app",
  app_id: "com.spotify.music",
  provider: "google-play",
});

// Get alerts and anomalies
const alerts = await client.call("get_alerts", { app_id: "com.spotify.music" });

// Check usage and quota
const usage = await client.call("manage_credentials", { action: "usage" });

await client.disconnect();

# Auto-detect and configure all installed agents
npx appdatalayer-mcp setup

# Or print config JSON for manual setup
npx appdatalayer-mcp config sk_live_... --agent cursor

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

# stdio transport (for agents that spawn a subprocess)
npx appdatalayer-mcp serve --api-key sk_live_...

# HTTP transport (for network-based setups)
npx appdatalayer-mcp serve --transport http --port 3100 --api-key sk_live_...

await client.call("get_weekly_report", {
  app_id: "com.spotify.music",
});

await client.call("ask_about_my_app", {
  app_id: "com.spotify.music",
  question: "What do users love most?",
  days: 90,             // optional, default 90
  provider: "google-play", // optional
  country: "us",        // optional
  version: "9.0.0",     // optional
});

await client.call("get_alerts", {
  app_id: "com.spotify.music", // optional — omit for all apps
});

// Track an app across all regions (Pro)
await client.call("manage_tracking", {
  action: "track_app",
  app_id: "com.spotify.music",
  provider: "google-play",
});

// Create a webhook alert
await client.call("manage_tracking", {
  action: "create_webhook",
  app_id: "com.spotify.music",
  trigger_type: "sentiment_drop",
  webhook_url: "https://hooks.slack.com/...",
  check_frequency: "daily",
});

// Schedule weekly reports
await client.call("manage_tracking", {
  action: "schedule_report",
  app_id: "com.spotify.music",
});

// Check usage
await client.call("manage_credentials", { action: "usage" });

// Add Google Play credential
await client.call("manage_credentials", {
  action: "add",
  provider: "google_play",
  label: "My Production App",
  app_identifier: "com.example.myapp",
  service_account_json: '{ "type": "service_account", ... }',
});

// Add Apple credential
await client.call("manage_credentials", {
  action: "add",
  provider: "apple",
  label: "My iOS App",
  app_identifier: "com.example.myapp",
  issuer_id: "...",
  key_id: "...",
  p8_key: "-----BEGIN PRIVATE KEY-----\n...\n-----END PRIVATE KEY-----",
});

// Analyze reviews by sentiment and topic
await client.call("query_live_data", {
  query_type: "analyze_reviews",
  app_id: "com.spotify.music",
  dimensions: ["sentiment", "topic"],
  days: 30,
});

// Forecast keyword ranking
await client.call("query_live_data", {
  query_type: "forecast",
  metric: "keyword_ranking",
  app_id: "com.spotify.music",
  keyword: "music streaming",
  horizon: 14,
});

// Search topics
await client.call("query_live_data", {
  query_type: "topics",
  topic_action: "search",
  query: "app crashes and freezes",
});

// Fetch real-time data from store
await client.call("query_live_data", {
  query_type: "fetch_realtime",
  provider: "google-play",
  feature: "app_detail",
  app_id: "com.instagram.android",
});

// Version analysis with regression detection (Pro)
await client.call("query_live_data", {
  query_type: "version_analysis",
  app_id: "com.spotify.music",
  detect_regression: true,
  days: 90,
});

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

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)
}

// Call any tool by name
const result = await client.call("tool_name", { ...args });

// List all available tools
const tools = await client.listTools();

// List all available resources
const resources = await client.listResources();

// Read a resource
const schema = await client.readResource("appdatalayer://schemas/all");

import { generateMcpConfig } from "appdatalayer-mcp";

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

# Interactive setup — browser auth + auto-configure agents
npx appdatalayer-mcp setup
npx appdatalayer-mcp setup --agent cursor
npx appdatalayer-mcp setup --api-key sk_live_...

# Print config JSON for manual setup
npx appdatalayer-mcp config <api-key> --agent <name>

# Run as standalone MCP server
npx appdatalayer-mcp serve --api-key <key>
npx appdatalayer-mcp serve --transport http --port 3100