README.md•1.79 kB
# 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
## Installation
```bash
git clone https://github.com/ysntony/appsflyer-mcp
cd appsflyer-mcp
uv sync
```
## Configuration
Set up your AppsFlyer API credentials as environment variables:
```bash
export APPSFLYER_API_BASE_URL="https://hq1.appsflyer.com"
export APPSFLYER_TOKEN="your_api_token_here"
```
Or create a `.env` file:
```env
APPSFLYER_API_BASE_URL=https://hq1.appsflyer.com
APPSFLYER_TOKEN=your_api_token_here
```
## Usage
### Running the MCP Server
```bash
uv run python run_server.py
```
### MCP Configuration
Add to your MCP configuration file:
```json
{
"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
```bash
uv sync --dev
pytest
```
## License
MIT License