How to Use the Nuviad Advertising MCP in Mastra AI

Q: How do I trigger Nuviad Advertising report generation in Mastra AI?

You define a workflow step that calls requestcampaignreport. Mastra AI then polls getreportstatus automatically using its workflow engine, ensuring you only try to read the data when it is fully compiled.

Q: How do I require human approval before Mastra AI modifies my Nuviad Advertising campaigns?

You configure requireToolApproval in your Mastra agent setup. Before the agent executes any MCP tool that might alter your budget or targeting, the workflow pauses and waits for a manual confirmation.

Q: Can I run these ad-tech workflows on a cron schedule using the MCP Server?

Yes. You can trigger your Mastra agent to run getreportssummary every hour. The workflow analyzes the summary and decides whether to fetch deeper campaign data or adjust targeting lists.

Automate multi-step RTB optimizations and bid adjustments using Mastra AI workflows and this dedicated MCP Server.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Nuviad Advertising MCP to Mastra AI

Create your Vinkius account to connect Nuviad Advertising 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 Nuviad Advertising with Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automated RTB bidding loops with Mastra AI

The `list_micro_margins` tool feeds current margin performance directly into Mastra AI workflow steps. When margins dip below your target threshold, the workflow triggers automated bid corrections. Mastra handles the conditional logic to adjust spend without human intervention. You use `list_micro_bids` to verify the new bid levels are applied correctly. If an API call fails, Mastra's built-in retry engine backs off and tries again automatically. This MCP loop keeps your programmatic bidding loop running even during high network traffic.

Self-healing reporting workflows

The `request_campaign_report` tool initiates detailed data exports that Mastra AI monitors step-by-step. The workflow engine polls `get_report_status` using exponential backoff to avoid rate limits. Once the status changes to complete, the workflow automatically grabs the data. Your agent then calls `get_report_content` to parse the performance metrics. If the report fails to generate, Mastra routes the error to your fallback step, notifying your team via Slack or retrying the request.

Automated targeting audits

The `list_targeting_lists` tool pulls active audience segments into Mastra's validation pipeline. Your agent compares these segments against active geolocations retrieved via `list_geo_locations`. The workflow flags mismatched campaigns instantly. It then cross-references active creatives using `list_creatives` to ensure proper asset mapping. Mastra executes these checks on a cron schedule, keeping your mobile campaigns optimized without manual intervention.

Setup guide

Set up Nuviad Advertising 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 Nuviad Advertising 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: "nuviad-advertising-mcp-client",
  servers: {
    "nuviad-advertising-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

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

const result = await agent.generate(
  "List recent Nuviad Advertising 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 Nuviad. 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 Nuviad Advertising 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 Nuviad Advertising MCP in Mastra AI

You define a workflow step that calls `request_campaign_report`. Mastra AI then polls `get_report_status` automatically using its workflow engine, ensuring you only try to read the data when it is fully compiled.

Yes. Mastra AI uses built-in exponential backoff to handle rate limits gracefully when calling `list_micro_bids`. If the server returns a temporary error, the workflow retries the call automatically without crashing your agent.

You configure `requireToolApproval` in your Mastra agent setup. Before the agent executes any MCP tool that might alter your budget or targeting, the workflow pauses and waits for a manual confirmation.

Yes. You can trigger your Mastra agent to run `get_reports_summary` every hour. The workflow analyzes the summary and decides whether to fetch deeper campaign data or adjust targeting lists.

Yes. Your Nuviad credentials are encrypted and managed directly by Vinkius. The Mastra agent connects using a single secure endpoint token, keeping your RTB configurations and targeting lists completely isolated, connecting via our secure MCP gateway.

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