# AdButler MCP for AI Agents AI Agent Connect

> AdButler MCP lets you manage your entire ad-serving network using natural language. Connect your account to your AI agent to audit publisher inventory, monitor campaign delivery, and pull real-time performance reports on impressions, clicks, and revenue. It turns complex ad ops into a simple conversation, helping you spot underperforming zones or high-performing creatives without ever leaving your chat interface.

## Overview
- **Category:** marketing-automation
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_of66CiHIRSE12rY60azurTIvsMtRClk3JHhRSNcN/ai-agent-connect
- **Tags:** ad-server, campaign-management, impression-tracking, display-advertising, ad-ops

## Description

Managing a large-scale ad network usually means jumping between dozens of tabs and filters to see if your campaigns are actually hitting their targets. You have to dig through dashboards to find which publishers are underdelivering or which ad zones are pulling in the highest click-through rates. This Connector changes that by bringing all your AdButler data directly into your AI agent. Instead of manual data entry or constant dashboard refreshing, you can just ask your agent to summarize your weekly revenue or check the status of a specific self-serve campaign. It handles the heavy lifting of data retrieval so you can spend your time on actual strategy. Because Vinkius hosts this connection, you can plug it into your existing workflow and start querying your inventory or creative assets in seconds. You'll get answers on things like publisher earnings or creative status instantly, allowing you to make faster decisions on where to shift your budget. It's about moving from 'how do I find this data' to 'what does this data mean for my bottom line.' You can quickly verify that your banners are live, see which publishers are active, and get a pulse on your network performance without ever having to open a separate browser window.

## Tools

### check_adbutler_status
Verify AdButler API connectivity

### get_advertiser
Get advertiser details

### get_campaign
Get campaign details

### get_stats
Get ad serving statistics

### list_advertisers
List all advertisers

### list_banners
List ad items in a campaign

### list_campaigns
See all active and pending self-serve advertising campaigns. This helps you keep track of what's live and what's still in the queue.

### list_placements
List all placements

### list_publishers
Get a full list of every publisher in your network. Use this to quickly see who is managing your ad inventory.

### list_zones
View all active ad placements for a specific publisher. This is great for checking where your ads are actually appearing.

## Prompt Examples

**Prompt:** 
```
List all publishers in my network.
```

**Response:** 
```
I've retrieved your publisher list. You have 12 active publishers, including 'Tech News', 'Sports Hub', and 'Gaming Daily'. Would you like to see the zones for any of these?
```

**Prompt:** 
```
Show me the performance for the last 30 days.
```

**Response:** 
```
Here is your 30-day performance summary:

- **Impressions**: 4.2M
- **Clicks**: 12,400
- **CTR**: 0.30%
- **Total Revenue**: $14,200

Would you like me to break this down by campaign?
```

**Prompt:** 
```
What zones does publisher 5521 have?
```

**Response:** 
```
Publisher 5521 has 4 active zones:

* Sidebar_Banner
* Top_Leaderboard
* Interstitial_Pop
* Footer_Sticky

Do you want to check the performance for any of these?
```

## Capabilities

### Audit publisher inventory
View a full list of every publisher currently managing ad inventory in your network.

### Monitor campaign statuses
Check the current status and targeting rules for all your self-serve advertising campaigns.

### Pull real-time performance stats
Get aggregated metrics on impressions, clicks, and revenue across your entire network.

### Manage ad creative assets
Browse your library of banners and videos to ensure your visual content is up to date.

### Identify high-performing zones
See active ad placements for specific publishers to find your best-performing inventory.

## Use Cases

### Quick Campaign Status Check
An Ad Ops Manager needs to check if 50 different campaigns are active. They ask the agent to list_campaigns and get a summary of pending ones.

### Real-Time Revenue Audit
A publisher wants to know their earnings for last week. The agent uses get_performance_report to show revenue and clicks for a specific date range.

### Creative Asset Verification
A marketing analyst needs to verify creative assets. They use list_creatives to see if the latest winter banners are live.

### Publisher Zone Discovery
An admin needs to find a specific publisher's zones. They use list_publishers to find the ID, then list_zones to see the placements.

## Benefits

- Stop digging through dashboards to find publisher stats with list_publishers, which lets you see your entire network at a glance.
- Track your campaign health instantly using list_campaigns to see statuses and targeting rules without manual searching.
- Get immediate answers on your ROI by pulling specific metrics like CTR and revenue through get_performance_report.
- Keep your visual content organized by using list_creatives to audit your banner and video assets in seconds.
- Spot underperforming placements faster by using list_zones to see exactly where your ads are being served.

## How It Works

The bottom line is that you turn your ad-serving dashboard into a conversational interface for instant data access.

1. Subscribe to the AdButler MCP on the Vinkius Marketplace.
2. Provide your AdButler Secret API Key in the configuration.
3. Ask your agent to pull reports, list publishers, or check campaign rules.

## Frequently Asked Questions

**Can the AdButler MCP help me track my ad revenue?**
Yes, it pulls revenue data directly into your chat, allowing you to see your earnings without navigating the main dashboard.

**How do I use AdButler MCP to audit my creatives?**
You can simply ask your agent to list your creatives. It will show you all your banners and videos so you can check if they are current.

**Does AdButler MCP support multiple publishers?**
Yes, it can retrieve the full list of publishers in your network, making it easy to manage large-scale inventory.

**Can I use AdButler MCP to check campaign statuses?**
It can list all active and pending self-serve campaigns for you, so you always know what is live and what is still in the queue.

**How does AdButler MCP make ad ops faster?**
It removes the need to manually click through dashboards to find specific data, letting you get answers to your questions in seconds.

**Can I get CTR reports with AdButler MCP?**
Yes, it pulls aggregated stats including CTR and impressions, giving you a quick pulse on your network's performance.

**Where do I find my AdButler API Key?**
Log in to your AdButler dashboard, go to **Settings** > **API Settings**. You can generate your Secret API Key there. Note that API access requires the API add-on to be enabled.

**Can I see real-time impressions and clicks?**
Yes! Use the `get_report` tool to retrieve up-to-the-minute statistics for your campaigns, zones, or entire network.

**Does this server support creative management?**
Yes, you can use the `list_creatives` tool to audit and manage the ad assets associated with your account.

**How do I find my AdButler API Key?**
Log in to your account, navigate to **Settings** > **API Access**, and copy your unique API Key from the credentials section.

**Can I check ad performance via AI?**
Yes! The `get_stats` tool retrieves impression and click data for all your active banners and campaigns.

**How do I list my advertisers?**
Use the `list_advertisers` tool to retrieve all advertiser profiles with their unique identifiers.