How to Use the AdsWizz MCP in Mastra AI

Q: How can Mastra AI automate daily AdsWizz performance reports?

Build a workflow that calls listcampaigns and then loops through the results, calling getaudioperformance for each one. Mastra AI's engine handles the looping and automatic retries if any call fails.

Q: Can I use Mastra AI to check if my AdsWizz campaigns are configured correctly?

Absolutely. Use getcampaign inside a Mastra AI workflow and apply conditional logic to compare the campaign's data against your business rules. You can then flag any discrepancies.

Q: How do I add the AdsWizz tools to my Mastra agent?

It's simple. After installing the package, you create a MCPClient instance pointing to your Vinkius URL. Then you call mcpClient.listTools() and spread the results into your Agent's toolset.

Build resilient advertising workflows for AdsWizz with Mastra AI. Automate campaign monitoring and reporting.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect AdsWizz MCP to Mastra AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate Daily Ad Reporting

Create a daily reporting agent that pulls audio ad data from AdsWizz. Your Mastra AI workflow can use `list_campaigns` to get all active campaigns, then loop through them using `get_audio_performance` to collect metrics for each one. If an API call fails, Mastra's built-in retry logic kicks in automatically. This means your reports don't fail just because of a temporary network hiccup. The workflow just keeps going.

Run Automated Campaign Checks

Build a workflow that validates your AdsWizz campaigns. Use the `get_campaign` tool to check details against your internal business rules, like confirming that every campaign has the correct targeting or budget settings. Mastra AI's conditional logic is key here. If a campaign fails validation, your workflow can automatically flag it for review or even attempt to correct it. This is what this MCP Server enables.

Monitor Ad Inventory Levels

Set up an agent to monitor your ad inventory. The `list_zones` tool gives you a list of all available ad placements, like podcasts and streams. Your workflow can periodically check this list and trigger alerts if inventory drops below a certain threshold. This isn't just a simple script. With Mastra AI, you can build a workflow that first checks inventory, then checks upcoming campaign end-dates, and then notifies the ad-ops team with a pre-formatted summary.

Setup guide

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

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

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

Build a workflow that calls `list_campaigns` and then loops through the results, calling `get_audio_performance` for each one. Mastra AI's engine handles the looping and automatic retries if any call fails.

Absolutely. Use `get_campaign` inside a Mastra AI workflow and apply conditional logic to compare the campaign's data against your business rules. You can then flag any discrepancies.

Mastra AI will automatically retry the request with exponential backoff. Your workflow won't fail because of temporary issues, making your automations much more reliable.

It's simple. After installing the package, you create a `MCPClient` instance pointing to your Vinkius URL. Then you call `mcpClient.listTools()` and spread the results into your Agent's toolset.

Your agent will access AdsWizz campaign configurations and audio ad performance numbers. Vinkius isolates every operation in a dedicated sandbox, and your unique endpoint token authenticates all communication. Data is only used for the duration of the tool call.

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