How to Use the TopOn / Mobvista MCP in Mastra AI

Q: How do I use TopOn / Mobvista reporting with Mastra AI?

You can build a multi-step process using gettoponreporting. If the initial report fails validation, your workflow engine automatically retries the call with exponential backoff to ensure data integrity.

Q: What if I need TopOn / Mobvista placement data with Mastra AI?

Use listtoponplacements in a workflow. If the list is empty, your agent can't just fail; it can trigger an alert to notify an admin immediately that placements are missing.

Q: Can I compare Mintegral and TopOn performance with Mastra AI?

Yes. You set up a workflow that first calls getmintegralreporting and then, upon successful completion, calls gettoponreporting. This allows for automated comparison logic within the agent framework.

Q: Does Mastra AI support getting an overall monetization summary?

Yes. A simple workflow step can call getmonetizationsummary to get a quick revenue check, which is ideal for automated daily or hourly checks.

Build complex, self-healing ad mediation pipelines with Mastra AI.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect TopOn / Mobvista MCP to Mastra AI

Create your Vinkius account to connect TopOn / Mobvista to Mastra AI and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup TopOn / Mobvista with Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate revenue analysis using the MCP Server.

The `get_monetization_summary` tool provides a total view of monetization. With Mastra AI, you can build a workflow that checks this summary; if it falls below a threshold, it automatically triggers another step. You also get deep visibility into placement performance by calling `get_topon_waterfall`. Your agent can use conditional branching to retry the analysis or notify an admin based on specific waterfall patterns.

Manage ad vendor inventory with Mastra AI.

Need to ensure all possible revenue streams are covered? Start by listing vendors using `list_mintegral_offers` and `list_topon_apps`. Mastra AI handles the sequence: it retrieves the list, checks for completeness, and then logs any missing entries. It’s also simple to pull a full inventory of active spots by calling `list_topon_placements`, making sure your ad network is fully accounted for in your workflow.

Track platform performance metrics with the MCP Server.

For vendor-specific data, Mastra AI runs workflows that call both `get_mintegral_reporting` and `get_topon_reporting`. This comparison is critical for understanding where revenue dips are happening. If you suspect an issue with a specific app, the workflow can automatically pivot to run `get_mintegral_app_stats`, allowing for targeted investigation without manual intervention.

Setup guide

Set up TopOn / Mobvista MCP in Mastra AI

Prerequisites

Node.js 18+ and a TypeScript project
@mastra/mcp + @mastra/core packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run npm install @mastra/mcp @mastra/core plus your preferred model provider (e.g. @ai-sdk/openai).
2

Configure the MCPClient
Create an MCPClient with your Vinkius endpoint as a URL object. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and inject tools
Call mcpClient.listTools() and spread the result into your agent's tools object. All TopOn / Mobvista tools become native Mastra tools.
4

Run with any model
Swap openai("gpt-4o") for any AI SDK-compatible provider. Call agent.generate() and the agent routes tool calls through MCP automatically.

agent.ts

import { MCPClient } from "@mastra/mcp";
import { Agent } from "@mastra/core/agent";
import { openai } from "@ai-sdk/openai";

const mcpClient = new MCPClient({
  id: "topon-mobvista-mcp-client",
  servers: {
    "topon-mobvista-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

const agent = new Agent({
  name: "TopOn / Mobvista Agent",
  model: openai("gpt-4o"),
  instructions: "You have access to TopOn / Mobvista tools.",
  tools: {
    ...(await mcpClient.listTools()),
  },
});

const result = await agent.generate(
  "List recent TopOn / Mobvista transactions"
);
console.log(result.text);

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by TopOn / Mobvista. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect TopOn / Mobvista now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about TopOn / Mobvista MCP in Mastra AI

You can build a multi-step process using `get_topon_reporting`. If the initial report fails validation, your workflow engine automatically retries the call with exponential backoff to ensure data integrity.

Use `list_topon_placements` in a workflow. If the list is empty, your agent can't just fail; it can trigger an alert to notify an admin immediately that placements are missing.

Yes. You set up a workflow that first calls `get_mintegral_reporting` and then, upon successful completion, calls `get_topon_reporting`. This allows for automated comparison logic within the agent framework.

Yes. A simple workflow step can call `get_monetization_summary` to get a quick revenue check, which is ideal for automated daily or hourly checks.

The server touches monetization figures. When you run workflows like `get_mintegral_app_stats`, the agent handles and processes application statistics, which are critical performance metrics.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript