How to Use the AdButler MCP in Mastra AI

Q: How do I initialize AdButler in Mastra AI?

Install @mastra/mcp@latest and instantiate a new client with your Vinkius URL. Spread the results of the tools list directly into your agent configuration.

Q: Can Mastra AI pull AdButler performance reports?

You configure a workflow to call getperformancereport on a schedule. The agent extracts clicks and impressions, then formats them for your daily marketing digest.

Q: Can I require human approval for AdButler changes in Mastra AI?

Setting requireToolApproval on specific actions forces the workflow to pause. An admin must manually authorize the step before the agent proceeds.

Engineer resilient ad management workflows with the AdButler MCP Server and 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 AdButler MCP to Mastra AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Mastra AI Campaign Audits

`list_campaigns` retrieves pending self-serve advertising orders for review. Mastra AI feeds those records into a workflow that checks asset availability via `list_creatives`. Missing banners trigger an automatic retry loop with exponential backoff before alerting the admin. Handling API rate limits manually wastes development time. The framework auto-detects the streamable HTTP transport and handles the connection state natively. Developers deploy these validation pipelines to their cloud with a single command.

Conditional Reporting Workflows

`get_performance_report` extracts impressions and clicks for specific date ranges. Your agent evaluates the CTR against a defined threshold. Low-performing campaigns route down a conditional branch that pauses the order and notifies the marketing team. Spreading `mcpClient.listTools()` into your Mastra agent exposes these actions directly. You wrap destructive or sensitive operations in a `requireToolApproval` block. Human operators stay in the loop when automated decisions affect ad spend.

Map Inventory via Mastra AI

`list_publishers` grabs the full roster of partners managing your ad inventory. The system iterates over that array, passing each ID to `list_zones` to build a complete map of active placements. Network failures during this heavy fetching process just trigger the built-in retry engine. Building complex data pipelines requires predictable error handling. This MCP integration prevents temporary AdButler outages from breaking your entire synchronization job. Your ad ops team gets reliable inventory catalogs every morning.

Setup guide

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

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

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

Install `@mastra/mcp@latest` and instantiate a new client with your Vinkius URL. Spread the results of the tools list directly into your agent configuration.

You configure a workflow to call `get_performance_report` on a schedule. The agent extracts clicks and impressions, then formats them for your daily marketing digest.

Mastra automatically applies exponential backoff if the ad network throttles your requests. Temporary failures during zone or publisher fetches resolve themselves without manual intervention.

Setting `requireToolApproval` on specific actions forces the workflow to pause. An admin must manually authorize the step before the agent proceeds.

Publisher IDs and zone configurations travel through an encrypted tunnel directly to your self-hosted instance. The MCP environment runs on a zero-trust architecture. Vinkius drops the sandbox immediately after execution.

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