# TopOn / Mobvista MCP

> TopOn / Mobvista MCP Server connects two major ad mediation platforms—TopOn and Mintegral—to your AI agent. It lets you instantly audit mobile game revenue streams, check placement waterfalls, compare eCPM trends, and pull performance reports from both systems without touching any dashboard. Your agent handles the complexity; you just ask the question.

## Overview
- **Category:** marketing-automation
- **Price:** Free
- **Tags:** ad-mediation, monetization, mobile-gaming, revenue-reporting, waterfall-management, ecpm-optimization

## Description

You're dealing with mobile ad revenue, right? You gotta look at TopOn *and* Mintegral. Instead of jumping between two totally different dashboards—which is a headache, trust me—you connect your AI agent to the TopOn / Mobvista MCP Server. This setup lets your agent treat both platforms like one single backend system. It’s how you get deep access into complex ad monetization data without lifting a finger and clicking through menus.

Your agent uses specific tools so you can run full, centralized audits straight from your chat window. You'll start by getting the big picture with `get_monetization_summary`. This tool pulls a single, aggregated view of total ad revenue trends across every connected account, giving you an instant snapshot of where your money’s coming from.

Need to dive deeper? Your agent can pull detailed performance data from either side. You run `get_topon_reporting` for historical and detailed metrics specific to TopOn, or you use `get_mintegral_reporting` when you need a full report on Mintegral’s general performance. If you're only interested in one game's numbers, you can narrow it down using `get_mintegral_app_stats`, which pulls app-specific metrics directly from the Mintegral system.

When optimizing placements, you'll use `get_topon_waterfall`. This tool runs an audit on TopOn’s ad placement configuration, checking health scores for specific units and pointing out exactly where you should change networks to improve results. Want to know what apps are running under the hood? You just run `list_topon_apps` to get a roster of every mobile game managed by TopOn.

For physical ad spots, you can list all unique placements configured in TopOn using `list_topon_placements`. If you're troubleshooting Mintegral’s inventory, running `list_mintegral_offers` shows you every available ad offer and campaign that's currently live through their system. To get the full scope of what’s working, your agent can also pull a list of all active mobile applications managed under TopOn via `list_topon_apps`.

It's about data flow. Your agent doesn't just fetch raw numbers; it compiles everything. It uses these tools to check placement waterfalls, pulls platform-specific reports, and gathers overall revenue snapshots so you can immediately identify low-performing ad networks and see specific recommendations for optimization opportunities without ever touching a dashboard.

When you ask your agent a question—say, 'How did Q3 performance compare?'—it's not going to just search Google. It calls the necessary tools: maybe `get_mintegral_reporting` *and* `get_topon_reporting`, then it synthesizes that complex data into plain English for you. You don't manage APIs or API keys; your AI client does all of that heavy lifting, giving you a clear analysis based on the metrics retrieved from both TopOn and Mintegral.

## Tools

### get_mintegral_app_stats
Retrieves specific performance statistics for an app within the Mintegral system.

### list_topon_apps
Provides a list of active mobile applications managed under the TopOn platform.

### list_topon_placements
Lists all unique ad placements and units configured within the TopOn system.

### get_mintegral_reporting
Pulls general, comprehensive performance reports and data from Mintegral.

### get_monetization_summary
Generates a high-level summary of total ad monetization metrics across all connected platforms.

### get_topon_reporting
Fetches detailed performance reports and historical data specifically from TopOn.

### get_topon_waterfall
Analyzes the ad placement waterfall configuration for TopOn, identifying potential optimization spots.

### list_mintegral_offers
Lists all available ad offers and campaigns running through Mintegral.

## Prompt Examples

**Prompt:** 
```
Show my monetization summary for today.
```

**Response:** 
```
Your overall monetization is looking strong today! Total revenue is approximately $1,240.50, up 5% from yesterday. Mintegral contributed the most to this growth. Would you like a breakdown by app?
```

**Prompt:** 
```
Check the waterfall health for placement 'ad-unit-772'.
```

**Response:** 
```
I've audited the waterfall for 'ad-unit-772'. The health score is 92/100. All networks are responding well, but I recommend testing Mintegral at the top of the waterfall for your Tier-1 regions to potentially boost eCPM.
```

**Prompt:** 
```
List my ad placements for app 'Galaxy Quest'.
```

**Response:** 
```
I found 4 active ad placements for 'Galaxy Quest': 'Main_Menu_Interstitial', 'Rewarded_Double_Coins', 'Level_End_Banner', and 'Offer_Wall'. Which one would you like to analyze?
```

## Capabilities

### Audit ad placement waterfalls
Runs the `get_topon_waterfall` tool to check the health score of specific placements and recommend network changes.

### Get overall revenue snapshots
Uses `get_monetization_summary` to pull a single, aggregated view of total ad revenue trends across all connected accounts.

### Pull platform-specific reports
Accesses detailed performance data from either Mintegral (`get_mintegral_reporting`) or TopOn (`get_topon_reporting`).

### List installed applications
Uses `list_topon_apps` to see a roster of all mobile games managed through the TopOn platform.

### Analyze app-level stats
Retrieves specific application performance metrics directly from Mintegral using `get_mintegral_app_stats`.

## Use Cases

### Troubleshooting a sudden eCPM drop.
The revenue dipped 15% yesterday. Instead of checking dashboards manually, you ask your agent to run `get_monetization_summary` and compare it against the historical data. The agent flags that Mintegral's performance is stable, but TopOn’s waterfall health score (via `get_topon_waterfall`) dropped significantly, pointing directly to a low-priority ad network as the culprit.

### Comparing two campaigns for synergy.
You're launching a new app and need to see how its monetization stacks up. You ask your agent to run `get_mintegral_app_stats` for the existing Mintegral campaign, then list all placements with `list_topon_placements`. The combined data lets you judge if the placement strategy is consistent across both ad networks.

### Initial platform setup audit.
You just onboarded a new game. You start by using `list_topon_apps` to confirm your access, then run `get_mintegral_reporting` and `get_topon_reporting` side-by-side. This gives you the baseline performance metrics needed to set up optimization goals.

### Identifying unused ad inventory.
You suspect there are placements that aren't earning revenue. You ask your agent to run `list_topon_placements` and then cross-reference the results with the data from `get_monetization_summary`. This quickly surfaces units that exist but aren't contributing to the bottom line.

## Benefits

- Instant cross-platform visibility. Use the agent to pull data from both Mintegral (`get_mintegral_reporting`) and TopOn (`get_topon_reporting`) simultaneously. You don't have to switch tabs or log into two different portals just to compare eCPM.
- Automated waterfall auditing. Don't guess where your ad revenue is leaking. Calling `get_topon_waterfall` gives you a health score and specific, actionable recommendations on placement order.
- Centralized KPI tracking. Instead of pulling separate CSVs, ask for an overall picture using `get_monetization_summary`. You get the total daily revenue trend in a single chat response.
- Inventory discovery. Need to know what apps you manage? Call `list_topon_apps` or check available campaigns with `list_mintegral_offers` before starting an audit.
- App-specific diagnostics. If one title is underperforming, use `get_mintegral_app_stats` to narrow down the issue immediately without running a full global report.

## How It Works

The bottom line is that you get cross-platform ad performance analysis without writing any API calls yourself.

1. Subscribe to the server and input your TopOn API Key alongside your Mintegral Skey.
2. Tell your agent what you need. For example: 'Compare today's eCPM trends using `get_mintegral_reporting` vs. `get_topon_reporting`.'
3. The agent executes the required tools, gathers data from both platforms, and presents a combined analysis or list of actionable insights.

## Frequently Asked Questions

**How do I get an overall picture of my revenue using TopOn / Mobvista MCP Server?**
You call `get_monetization_summary`. This tool aggregates the key metrics from both Mintegral and TopOn into one summary, so you don't have to run two separate reports just to see if things look good overall.

**What is the best way to check ad placements for a specific game?**
First, use `list_topon_apps` to ensure the app ID is correct. Then, run `get_mintegral_app_stats` or `get_topon_waterfall`, depending on which platform you want the performance data from.

**Can I see what offers Mintegral has available?**
Yes. Call `list_mintegral_offers`. This tool simply lists all the specific ad campaigns and inventory deals that are currently running through Mintegral for your apps.

**Does get_topon_waterfall tell me why my revenue is low?**
It doesn't give a 'why,' but it gives you the audit score. The health score from `get_topon_waterfall` points directly to suboptimal placement ordering or poor network performance, telling you where your effort needs to go.

**What credentials are required when using the `get_mintegral_reporting` tool?**
You need your Mintegral API Key and the relevant App ID. The server uses these identifiers to securely pull performance data from Mintegral's platform. Make sure you have those keys entered into the server settings for it to run.

**How do I list all my available TopOn applications using `list_topon_apps`?**
Running `list_topon_apps` provides a comprehensive inventory of every application ID associated with your account. This is useful for verifying which apps the server can access and reporting on.

**What specific metrics does the tool `get_mintegral_app_stats` return?**
The function gathers key statistics per app, including total installs, average daily revenue, and historical eCPM trends. This lets you quickly compare performance across different game titles.

**What type of data can I retrieve using `get_topon_reporting`?**
This tool pulls detailed performance metrics specific to TopOn placements. You'll get breakdowns on impressions, clicks, ad fill rates, and revenue contribution segmented by date range.

**How do I find my TopOn API Key?**
Log in to your TopOn dashboard, go to the [API Tools] section, and you will find your Management and Reporting API keys there.

**Can I audit my waterfalls using this agent?**
Yes! You can use the `check_waterfall_health` tool for a specific placement ID to get an AI-driven audit of your fill rates, latency, and optimization recommendations.

**Is reporting available for both TopOn and Mintegral?**
Yes, this server integrates both TopOn Reporting and Mintegral Reporting V2, allowing you to pull performance data from both sources in one place.