# AdButler MCP MCP

> AdButler MCP gives you full, conversational control over your ad inventory and performance data. It lets your agent list campaigns, track real-time impressions, retrieve advertiser details, and audit zone health across any digital property without needing manual dashboard checks or complex API calls.

## Overview
- **Category:** marketing-automation
- **Price:** Free
- **Tags:** ad-server, campaign-management, impression-tracking, display-advertising, ad-ops

## Description

Stop logging into a dozen dashboards just to check how well your ads are running. This MCP connects directly to your AdButler account, giving your AI client the full authority to manage ad serving and track performance through natural conversation. You can ask it to list every active advertiser, retrieve detailed metadata on specific banners, or get real-time stats across all zones—all in one go. If you connect this via Vinkius, your agent becomes a dedicated ad coordinator and inventory architect, handling complex data pulls that used to require developer time. It takes the guesswork out of campaign orchestration and ensures every piece of high-fidelity asset metadata is accounted for.

## Tools

### check_adbutler_status
Verifies if your API connection to AdButler is currently working.

### get_advertiser
Retrieves specific details about a single advertiser profile.

### get_campaign
Gets the full metadata and status for one particular campaign.

### get_stats
Pulls ad serving statistics, like impressions and clicks, for a given period.

### list_advertisers
Lists all the advertisers linked to your account.

### list_banners
Retrieves a list of ad creative assets within an existing campaign.

### list_campaigns
Lists every active and inactive campaign on your account.

### list_placements
Lists all ad placement settings across your site.

### list_publishers
Retrieves a list of publishers associated with the account.

### list_zones
Lists all specific ad zones you have set up for serving ads.

## Prompt Examples

**Prompt:** 
```
List all active advertisers in my AdButler account.
```

**Response:** 
```
I've retrieved your advertisers. You currently have 10 active high-fidelity profiles, including 'Global Brands' and 'Local Retailer'. Would you like the detailed campaign metadata for any of them?
```

**Prompt:** 
```
Show the performance for 'Banner A' from yesterday.
```

**Response:** 
```
Ad intelligence orchestrated! For Banner A, I've identified 1,000 high-fidelity impressions and 50 clicks (CTR: 5%) from yesterday. I've retrieved the technical delivery metadata for your review. Need help auditing the conversion rate?
```

**Prompt:** 
```
Check for any campaigns expiring this week.
```

**Response:** 
```
Operational monitoring orchestrated! I've identified 2 high-fidelity campaigns expiring this week, including 'Summer Sale' on Friday. I've retrieved the advertiser contact metadata for your review. Shall I notify the ad ops team?
```

## Capabilities

### Audit Ad Campaign Status
Check the live connectivity status of your ad account or list all active campaigns and advertisers.

### Review Asset Details
Retrieve technical metadata for specific ad banners, placements, publishers, and zones.

### Analyze Performance Metrics
Pull serving statistics that include impression counts and click rates across defined time periods.

## Use Cases

### Auditing a new client launch
A publisher needs to confirm all ad zones are ready for a major campaign. Instead of navigating through zone settings, they ask the agent to use `list_zones` and `get_advertiser` to ensure both placement metadata and advertiser details match up perfectly before going live.

### Weekly performance review
An Ad Ops Manager needs a cross-section of data: which campaigns were most active, how many impressions they generated, and if any are nearing expiration. The agent calls `list_campaigns`, then uses `get_stats` and checks for expiring items in one query.

### Debugging ad asset failures
A developer finds that some ads aren't showing up. They use the agent to call `list_banners` for a specific campaign, instantly checking if all required creative assets are available and linked correctly.

### Quick inventory check
You need to confirm which publishers contributed ad inventory in a given month. You ask the agent to use `list_publishers` and then cross-reference that data with current campaign records, saving hours of manual filtering.

## Benefits

- Stop manually checking campaign expiration dates. Your agent monitors operational status, alerting you immediately if any campaigns are running out or need attention.
- You get instant access to ad serving stats via the `get_stats` tool. Instead of pulling CSV reports, ask your AI client for total impressions and clicks from a specific date range.
- Need an overview? Use `list_advertisers` and `list_campaigns` together. Your agent gathers metadata on all high-fidelity profiles so you can audit the whole account in minutes.
- No more guessing about asset availability. You can use `list_banners` to see which creative assets belong to a campaign, confirming everything is ready to go live.
- Confirming your ad tech stack works? The `check_adbutler_status` tool verifies API connectivity instantly, so you know the data source isn't broken before you write code.

## How It Works

The bottom line is you use natural language to query highly specific ad serving data that was previously locked in separate dashboards.

1. Subscribe to the AdButler MCP on Vinkius.
2. Copy your API Key from your AdButler dashboard settings.
3. Ask your AI client (like Cursor or Claude) a question, such as 'What were the stats for Campaign X last week?'

## Frequently Asked Questions

**How do I get historical stats using the AdButler MCP?**
You use the `get_stats` tool. You just need to tell your agent the exact date range and what metrics you want, like impressions or clicks.

**Can the AdButler MCP list all active advertisers?**
Yes, you can run `list_advertisers`. This pulls a clean roster of every high-fidelity advertiser profile linked to your account.

**What is the difference between listing zones and placements with AdButler MCP?**
The `list_zones` tool shows defined ad slots, while `list_placements` tracks where those ads are actually shown on your digital properties. They are related but distinct data points.

**What if I need campaign details and stats together? AdButler MCP?**
You ask your agent to retrieve the `get_campaign` metadata, then immediately follow up with a request using `get_stats` for that specific campaign ID. The agent links the data points automatically.

**How do I verify my API key connection using the AdButler MCP?**
Use `check_adbutler_status` to confirm connectivity instantly. This tool validates your credentials and ensures your agent is ready to pull all data without any manual setup checks.

**What does running list_publishers provide about my ad inventory?**
It retrieves a comprehensive directory of every publishing account linked to your system. This lets you confirm the full scope of parties included in your ad network before optimizing campaigns or zones.

**What is the best way to manage multiple placements using the AdButler MCP?**
You should use `list_placements` first to get a master record. This ensures you have all current placement IDs and metadata needed for accurate campaign setup.

**What happens if I run too many queries with the AdButler MCP?**
The agent handles sequential calls, but remember that external API rate limits exist. If you get an error about capacity, wait a minute and retry your request; the tool will report the exact failure code.

**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.