# Adikteev MCP MCP

> Adikteev connects professional app retargeting and user retention insights directly into your workflow. Manage custom audience segments, retrieve campaign performance data, or access churn probability scores—all without leaving your chat client. This MCP helps you monitor the full mobile growth ecosystem using natural conversation.

## Overview
- **Category:** marketing-automation
- **Price:** Free
- **Tags:** retargeting, churn-prediction, mobile-growth, audience-segmentation, campaign-performance, user-retention

## Description

You can connect Adikteev to your AI agent to handle complex app retargeting and user retention work. Think of it like having a dedicated marketing analyst available 24/7, who speaks plain English. Your agent manages everything from setting up custom audience segments for specific campaigns to monitoring overall performance and finding out exactly which users are at risk of leaving. When you're working inside the Vinkius catalog, your AI client handles this entire mobile growth cycle through simple conversation, letting you audit retargeting efforts and identify high-value user groups on demand.

## Tools

### list_companies
Gets a list of companies you are associated with, providing technical IDs needed for audience management.

### list_segments
Retrieves a current list of all existing audience segments managed in the Adikteev account.

### create_segment
Builds a new, defined audience segment for use in future retargeting campaigns.

### get_churn_scores
Pulls specific probability scores to identify which users are likely to stop using the app.

### get_reporting
Retrieves detailed performance data on past retargeting campaigns and their overall impact.

## Prompt Examples

**Prompt:** 
```
List all audience segments for my company.
```

**Response:** 
```
I've retrieved your audience segments. You have 5 active segments, including 'Inactive Users (30d)', 'High Value Purchasers', and 'Cart Abandoners'. Would you like to create a new one?
```

**Prompt:** 
```
Retrieve the churn scores for my app with bundle 'com.example.app'.
```

**Response:** 
```
I've retrieved the churn score data for bundle 'com.example.app'. I have a list of users ranked by churn probability from 1 to 10. Would you like to identify the users in bucket 10 (highest risk)?
```

**Prompt:** 
```
Show me the performance of my retargeting campaigns.
```

**Response:** 
```
I've pulled the reporting data. Your active retargeting campaigns have reached 50,000 users with an average re-engagement rate of 12%. Would you like to see the ROI for a specific campaign?
```

## Capabilities

### Define target audiences
You can list or create specific audience segments needed for targeted app campaigns.

### Predict user churn risk
It retrieves probability scores that flag which users are most likely to stop using the app soon.

### Audit campaign ROI
You get detailed reports on how well past campaigns performed, tracking key engagement metrics.

### Scope company data
The tool lists existing companies and retrieves necessary technical metadata for segment setup.

## Use Cases

### The App Store Optimization Check
A UA manager needs to know if their latest ad campaign reached the correct user pool. They ask their agent to use `list_companies` first, then `get_reporting`, and finally check segment overlap using `list_segments`. This confirms they hit the target audience without wasting ad spend on irrelevant groups.

### The Proactive Retention Alert
A retention specialist runs a prompt asking for users with high risk. The agent uses `get_churn_scores` to pull the list, allowing the specialist to manually trigger an incentive program *before* those users hit zero engagement.

### The New User Onboarding Flow
A growth marketer wants to create a segment for 'users who used feature X but never purchased.' They use `create_segment` with specific criteria, formalizing the hypothesis instantly and making sure the retargeting ads hit the right people.

### The Data Audit Cleanup
A data analyst needs a full overview of all current segments before starting a new project. Running `list_segments` provides an immediate, comprehensive list, preventing them from accidentally duplicating or missing key user groups.

## Benefits

- Stop guessing about retention. Using `get_churn_scores`, you instantly identify high-risk users, allowing your team to launch targeted re-engagement campaigns before the user even notices they're leaving.
- Manage audiences faster than ever. You can use `create_segment` to build new, precise groups based on complex criteria—all through a simple chat command instead of navigating multiple UI forms.
- Quickly prove campaign value. Need to know if your last retargeting push actually worked? Run `get_reporting` to pull detailed data on ROI and engagement rates right away.
- Never lose scope again. The `list_companies` tool gives you the necessary technical IDs, ensuring that any segment or report you run is tied to the correct corporate entity.
- Keep your finger on the pulse. By using `list_segments`, you get a clean rundown of every existing audience group, helping prevent redundant segmentation efforts.

## How It Works

The bottom line is, your AI agent runs complex marketing analyses using only natural language prompts.

1. First, subscribe to this MCP and plug in your Adikteev API credentials (email and password).
2. Next, give your AI client a specific request, like 'List all segments for my top-tier users' or 'What is the churn score for bundle X'.
3. Finally, the tool executes the action via Adikteev and feeds you the data—whether it’s segment lists, performance metrics, or risk scores—right in the chat.

## Frequently Asked Questions

**How do I start using the Adikteev MCP with `list_companies`?**
You first ask your agent to run `list_companies`. This pulls a list of all companies associated with your account, giving you the technical metadata required before building any segments or running reports.

**What is the best way to check user risk using `get_churn_scores`?**
Simply ask your agent for 'the churn scores for my app.' It returns a ranked list of users, making it easy to identify who needs immediate attention.

**Can I use `create_segment` before running reports?**
Yes. You define the segment first using `create_segment`. Once that's done, you can then ask for performance data specifically related to that newly created audience group.

**Do I need to run `list_segments` before running a report?**
No. While `list_segments` shows what exists, the agent doesn't require you to manually list them first. You can just ask for 'the performance of all my segments,' and it handles the process.

**Do I need to run `list_companies` first before using `create_segment`?**
Yes, you should confirm your company ID first. Running `list_companies` ensures your MCP connects to the right account. This prevents errors when your agent tries to create a segment in the wrong system.

**How do I manage API rate limits if I use `get_churn_scores` frequently?**
Adikteev may impose usage caps on API calls. If your agent hits a limit, it returns an explicit error code. You’ll need to pause and retry the request later or check the dedicated Adikteev dashboard for current limits.

**What is the data freshness when I get campaign performance using `get_reporting`?**
The reporting data reflects real-time or near real-time activity. While it updates quickly, always check the Adikteev documentation for the exact sync interval to guarantee absolute accuracy.

**When should I use `list_segments` versus checking segments in the UI?**
Use `list_segments` when you need an automated inventory of all your current audience definitions. It’s faster and better for scripting than reading the user interface, helping you track all existing segments quickly.

**How do I get my Adikteev API account?**
You must contact your Adikteev Account Manager to have them enable API access for your account. Once enabled, you can use your standard login credentials (email and password) to authorize the agent.

**What is a Churn Score?**
A churn score ranks app users by their probability of leaving. Adikteev provides these in 'buckets' from 1 to 10, where 10 represents the highest risk of churn.

**How do I create a new audience segment?**
Use the `create_segment` tool and provide your `companyId`, a name, and a description. Your agent will create the segment in Adikteev and provide a `segmentId` for device ID uploads.