# AdsWizz MCP MCP

> AdsWizz connects your AI agent directly to an entire digital audio advertising platform. It lets you manage complex campaigns, audit publisher inventory zones, and pull granular performance metrics for programmatic ads—all through natural conversation.

## Overview
- **Category:** marketing-automation
- **Price:** Free
- **Tags:** audio-advertising, programmatic-ads, inventory-management, campaign-orchestration, targeting, digital-audio

## Description

You can run your entire audio ad operation from your chat window. This MCP allows your AI client to interact with every facet of your digital audio ecosystem, whether you're running streaming promos or podcast sponsorships. It handles everything from listing active campaigns across your network to auditing publisher inventory and verifying targeting parameters like geo-location or device type.

When you use this through Vinkius, your agent doesn't just read data; it orchestrates workflows. You can ask the system to monitor performance metrics for a specific ad zone, retrieve full campaign details, and then pull aggregated reports—all without ever leaving your chat interface. It’s about getting immediate answers on things like listen counts or completion rates by letting your agent call the necessary tools in sequence.

## Tools

### list_campaigns
Lists every active audio advertising campaign currently running in your network.

### get_campaign
Pulls all necessary details and parameters for a single specified ad campaign.

### list_zones
Retrieves a list of all available ad zones and inventory slots for your publisher account.

### get_audio_performance
Retrieves detailed audio advertisement metrics, allowing you to filter the data by specific dates.

## Prompt Examples

**Prompt:** 
```
List all active audio campaigns.
```

**Response:** 
```
I've retrieved your campaigns. You currently have 8 active audio campaigns, including 'Summer Streaming Promo' and 'Podcast Sponsorship A'. Which one would you like to inspect?
```

**Prompt:** 
```
Retrieve the targeting details for campaign ID 45678.
```

**Response:** 
```
I've fetched the details for campaign 45678. It is currently targeting users in North America and Europe, specifically on iOS devices, with a frequency cap of 3 ads per user per day.
```

**Prompt:** 
```
List the ad zones available for my publisher account.
```

**Response:** 
```
I've retrieved your ad zones. You have 12 active zones configured, primarily pre-roll and mid-roll slots for your main podcast network. Would you like to check the fill rate for any specific zone?
```

## Capabilities

### Audit Publisher Inventory
List and check the status of all available ad zones, whether they're pre-roll slots or mid-stream placements.

### Track Campaign Status
Retrieve a list of every active audio advertising campaign running across your accounts.

### Monitor Performance Metrics
Get filterable reports detailing ad performance, including listen counts and completion rates for specific dates.

### Inspect Campaign Details
Pull granular information on a single campaign, such as its current targeting rules or budget status.

## Use Cases

### Checking Post-Campaign Performance
A Marketing Analyst needs to prove ROI from a summer streaming campaign. They ask their agent to call `list_campaigns` first, find the correct ID, and then use `get_audio_performance` to pull metrics for the last quarter. This confirms the promo's actual listen count versus the projected goal.

### Fixing a Missing Ad Slot
A Podcast Network Publisher notices revenue dipping. They immediately use `list_zones`. If critical pre-roll slots are missing, they know exactly which zone needs to be added and can report the gap instantly.

### Verifying Target Audience Rules
A Programmatic Buyer suspects a campaign is running in the wrong region. They use `get_campaign` to retrieve the current targeting parameters, confirming whether it's set for North America or if it accidentally defaulted to Europe.

### Quick Status Check
An Ad Ops Manager just got an alert about a major promotion. They use `list_campaigns` to confirm the campaign is still active, then ask their agent to get its latest performance metrics using `get_audio_performance`.

## Benefits

- Audit Campaign Status: Instantly run `list_campaigns` to see every active ad promotion without logging into the platform. You get a complete overview in seconds.
- Pinpoint Performance Issues: Use `get_audio_performance` to pull date-filtered metrics, letting you prove exactly when and where performance dropped off.
- Validate Inventory Health: Running `list_zones` ensures your publisher account has all necessary ad slots configured. You can quickly spot underperforming zones.
- Get Campaign Deep Dives: When a campaign is confusing, call `get_campaign`. This pulls the full record—including targeting rules and setup details—in one shot.
- Cross-Reference Data: Combine tool calls; for instance, listing campaigns and then getting performance data allows you to tie specific metrics back to the right promo.

## How It Works

The bottom line is: you talk to your AI client, and it speaks to AdsWizz on your behalf.

1. Subscribe to this MCP and provide your AdsWizz Instance URL and API Key.
2. Connect your preferred AI client (Claude, Cursor, etc.) to the Vinkius catalog.
3. Tell your agent what you need—for example, 'Show me the performance metrics for Q2.' The agent handles calling the right tools in sequence.

## Frequently Asked Questions

**How do I check ad performance with get_audio_performance?**
You tell the agent to run `get_audio_performance` and specify the date range you need. It filters the raw data, returning metrics like listen counts and completion rates for that period.

**Can I list all my ads at once using list_campaigns?**
Yes. Calling `list_campaigns` pulls a master roster of every audio ad campaign currently active in your entire network, giving you immediate visibility into your live assets.

**What is the purpose of list_zones? **
Running `list_zones` tells you exactly which ad spots or inventory zones are available for sale. This is crucial for publishers to ensure they maximize their revenue and fill rate.

**How do I get campaign details using get_campaign?**
You pass the specific Campaign ID to `get_campaign`. The result gives you a complete record of that single campaign, including its full setup and targeting parameters.

**Before I run `list_campaigns`, what credentials do I need to connect my AdsWizz account?**
You must provide your specific AdsWizz Instance URL and a valid API Key. Vinkius handles the secure connection; just input these details into your AI client after subscribing.

**How do I filter dates when using `get_audio_performance` to check ad metrics?**
You specify the required date range directly in your prompt. Your agent lets you define start and end dates, allowing you to narrow down performance reports exactly how you need them.

**If `list_zones` returns an error, what does it indicate about my publisher inventory?**
An 'Unauthorized' error usually means your API Key needs refreshing. You should verify the key is current and that the account has proper access to the desired ad zone inventory.

**When inspecting campaign setup with `get_campaign`, what specific details can I retrieve?**
The tool provides full campaign specifications, including detailed targeting parameters (geo, device) and required creative configurations. This lets you verify the ad is set up correctly before launch.

**Where do I find my AdsWizz API Key?**
API access must be provisioned by your AdsWizz account manager. Once enabled, you can generate an API key from the MyAdsWizz developer portal or account settings. You will also need to know your specific instance URL.

**Can I check the targeting rules for a specific campaign?**
Yes! Use the `get_campaign` tool with the Campaign ID. It will return the full configuration, including geographic, demographic, and device targeting rules.

**Does this work for podcast advertising?**
Absolutely. AdsWizz handles dynamic ad insertion (DAI) for podcasts. You can use the `list_zones` tool to manage podcast inventory placements.