Skip to main content
Glama
AppsFlyer MCP Server

AppsFlyer MCP Server

by ysntony

AppsFlyer MCP Server

A Model Context Protocol (MCP) server for integrating AppsFlyer analytics data with AI assistants.

Features

  • Fetch aggregate data reports from AppsFlyer Pull API

  • Support for multiple report types: partners_report, partners_by_date_report, daily_report, geo_report, geo_by_date_report

  • Secure API token authentication

  • Type-safe input validation with Pydantic

Related MCP server: Meta Marketing API MCP Server

Installation

git clone https://github.com/ysntony/appsflyer-mcp
cd appsflyer-mcp
uv sync

Configuration

Set up your AppsFlyer API credentials as environment variables:

export APPSFLYER_API_BASE_URL="https://hq1.appsflyer.com"
export APPSFLYER_TOKEN="your_api_token_here"

Or create a .env file:

APPSFLYER_API_BASE_URL=https://hq1.appsflyer.com
APPSFLYER_TOKEN=your_api_token_here

Usage

Running the MCP Server

uv run python run_server.py

MCP Configuration

Add to your MCP configuration file:

{
  "mcpServers": {
    "appsflyer": {
      "command": "uv",
      "args": ["run", "python", "run_server.py"],
      "cwd": "/path/to/appsflyer-mcp",
      "env": {
        "APPSFLYER_API_BASE_URL": "https://hq1.appsflyer.com",
        "APPSFLYER_TOKEN": "your_api_token_here"
      }
    }
  }
}

Available Tools

  • get_aggregate_data: Fetch aggregate data reports from AppsFlyer Pull API

  • test_appsflyer_connection: Test the connection to AppsFlyer API

Report Types

  • partners_report: Partner performance data

  • partners_by_date_report: Daily partner performance data

  • daily_report: Daily aggregate data (default)

  • geo_report: Geographic performance data

  • geo_by_date_report: Daily geographic performance data

Development

uv sync --dev
pytest

License

MIT License

Available Tools

2 tools
get_aggregate_dataC

Fetches aggregate data reports from the AppsFlyer Pull API.

Inputs: data (required).

test_appsflyer_connectionB

Test the connection to AppsFlyer API and return server status.

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.1/5.0

    Scored across 2 tools

    Disambiguation5/5

    The two tools have clearly distinct purposes: one fetches aggregate data reports for analytics, while the other tests the API connection for operational status. There is no overlap or ambiguity in their functions, making it easy for an agent to select the correct tool based on the task.

    Naming Consistency5/5

    Both tools follow a consistent verb_noun naming pattern (get_aggregate_data, test_appsflyer_connection), using snake_case and clear, descriptive verbs. This uniformity aids in predictability and readability across the tool set.

    Tool Count2/5

    With only two tools, the server feels thin for an AppsFlyer analytics domain, which typically involves more operations like querying specific metrics, managing campaigns, or handling user data. The limited scope may hinder agents from performing comprehensive tasks, suggesting an underdeveloped surface.

    Completeness2/5

    The tool set is severely incomplete for an AppsFlyer analytics server. It lacks essential operations such as retrieving detailed reports, filtering data, managing integrations, or performing CRUD actions on resources. This gap will likely cause agent failures in handling typical analytics workflows beyond basic data fetching and connection testing.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to access App Store Connect data including financial metrics, subscription analytics, app performance data, and revenue insights. Provides real-time iOS app metrics through secure API integration with rate limiting and comprehensive reporting capabilities.
      29 npm
      36
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to manage Facebook and Instagram advertising data through the Meta Marketing API. It supports full campaign lifecycle management, performance analytics, audience targeting, and creative optimization.
      808 npm
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Exposes DataFast analytics as tools for AI assistants, enabling natural language queries about website metrics such as visitors, referrers, revenue, and real-time data.
      22
      1
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI assistants to query the FoxData API for iOS and Google Play app analytics, including downloads, revenue, rankings, keywords, competitor insights, and ad data across 200+ countries. Supports natural-language requests to retrieve app intelligence and market data.
      MIT