How to Use the AdButler MCP in Mastra AI

Q: How do I configure Mastra AI to retry failed AdButler API calls?

Define a workflow where your agent uses getstats. Mastra AI's built-in step configuration lets you set retry attempts and backoff intervals specifically for that tool execution.

Q: Can I require human approval before Mastra AI pulls AdButler placement data?

Yes, configure requireToolApproval on the listplacements tool. The agent will pause and wait for your confirmation before fetching the active zone structures.

Q: How do I register the AdButler MCP Server inside a Mastra AI agent?

Instantiate new MCPClient with your Vinkius URL, call mcpClient.listTools(), and spread those tools directly into your Mastra agent configuration array.

Build resilient, self-healing AdButler workflows with Mastra AI and automated agent retries.

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

Self-healing AdButler tasks with Mastra AI

The `list_campaigns` and `get_stats` tools query active ad metrics and schedules. Ad networks can be flaky, but your workflows do not have to be. Mastra AI wraps your tool calls in resilient execution loops that automatically retry with exponential backoff if the AdButler API hiccups. If a critical call like `get_advertiser` fails repeatedly, the workflow branches automatically to alert your team via Slack while pausing downstream actions.

Secure placement approvals using Mastra AI

The `list_placements` and `list_zones` tools fetch configuration details for live ad zones. Never let an agent modify or audit live placements without a second pair of eyes. Set `requireToolApproval` on sensitive tools to halt execution until a manager clicks approve. This ensures your agent can gather the layout options, but actual deployment decisions remain firmly in human hands.

Complex ad auditing via this MCP Server

The `list_publishers` and `list_banners` tools drill down into specific publisher assets. Build complex state machines that fetch all publishers, find their active zones, and pull the associated creatives. Mastra AI manages the state across these sequential calls, letting you map out intricate dependency graphs without writing spaghetti code.

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-alternative-mcp-client",
  servers: {
    "adbutler-alternative-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

Define a workflow where your agent uses `get_stats`. Mastra AI's built-in step configuration lets you set retry attempts and backoff intervals specifically for that tool execution.

Yes, configure `requireToolApproval` on the `list_placements` tool. The agent will pause and wait for your confirmation before fetching the active zone structures.

Instantiate `new MCPClient` with your Vinkius URL, call `mcpClient.listTools()`, and spread those tools directly into your Mastra agent configuration array.

Mastra AI automatically detects the transport layer, using either Streamable HTTP or SSE to communicate with the Vinkius hosting environment.

Your API keys are injected at runtime via environment variables directly to the Vinkius V8 sandbox. This ephemeral setup ensures your publisher lists and publisher IDs are never cached or written to disk.

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