# AdButler MCP MCP > AdButler connects your ad operations directly to your agent. It lets you audit publisher inventory, track campaign performance, and analyze revenue data through simple chat commands. Stop jumping between dashboards; get real-time reports on impressions, clicks, and CTR instantly. ## Overview - **Category:** marketing-automation - **Price:** Free - **Tags:** ad-serving, inventory-management, campaign-tracking, click-through-rate, ad-ops, publisher-management ## Description Manage your entire ad serving process conversationally. Instead of diving deep into multiple dashboard tabs to figure out if a zone is underperforming or which creative asset is failing, you just talk to your agent. It handles the heavy lifting, giving you full control over every publisher, placement, and campaign across your network. When you connect this MCP via Vinkius, your agent can pull together ad performance data—like revenue totals or click-through rates—from any compatible client. You get instant visibility into everything from listing all available assets to checking the metrics for a specific zone. It’s like having an expert Ad Ops manager sitting next to you, ready to answer every technical question about your ads. ## Tools ### list_campaigns Gets a list of all active or pending self-serve advertising campaigns in AdButler. ### list_publishers Gets a full list of all publishers that manage ad inventory within your network. ### list_zones Retrieves the specific active ad zones (placements) linked to a particular publisher ID. ### list_creatives Retrieves the entire library of ad assets, including banners and videos, stored in your account. ### get_performance_report Retrieves aggregated metrics like impressions, clicks, and CTR across your network zones and campaigns. ## Prompt Examples **Prompt:** ``` List all publishers in my AdButler network. ``` **Response:** ``` I've retrieved the list of publishers. You have 10 active publishers, including 'Tech Daily', 'News Corp', and 'Gaming Hub'. Would you like to see the zones for any of them? ``` **Prompt:** ``` Show me the performance report for the last 7 days. ``` **Response:** ``` I've retrieved your 7-day performance report. Your network served 1.2M impressions with 5,400 clicks (CTR: 0.45%) and generated $3,200 in revenue. Which metric would you like to dive deeper into? ``` **Prompt:** ``` List all active zones for publisher ID 12345. ``` **Response:** ``` I've found 5 active zones for publisher 12345: 'Sidebar Banner', 'Top Leaderboard', 'Interstitial', and others. Would you like to check the current fill rate for these zones? ``` ## Capabilities ### Get Performance Metrics Retrieve aggregated data points—impressions, clicks, and CTR—across any of your ad zones or campaigns. ### Check Campaigns List all active and pending self-serve advertising campaigns to confirm their status and targeting rules. ### Review Placements Fetch a full list of ad zones (placements) tied to any specific publisher ID. ### Audit Publishers Get the complete roster of publishers managing ad inventory within your network. ### Manage Assets View and list all ad creative assets, such as banners or videos, stored in your account library. ## Use Cases ### Diagnosing a Drop in Revenue A publisher notices revenue is down. They ask their agent to run `get_performance_report` for the last week, comparing it against last month's data. The report pinpoints that clicks dropped specifically within zones associated with 'Tech Daily', leading them to check those placements via `list_zones` and fix the placement. ### Auditing a New Campaign Launch A marketing analyst needs to verify all ad assets before launch. They run `list_creatives` first, ensuring the correct version of the banner is available. Then they use `list_campaigns` to confirm the campaign status and check its targeting parameters. ### Scaling Publisher Coverage An Ad Ops Manager onboarded a new publishing partner. They use `list_publishers` to verify the ID, then immediately run `list_zones` using that new ID. This confirms all available placements are correctly accounted for in their reporting structure. ### Preparing Quarterly Reports A team member needs a single data source for Q3 performance. They use the agent to execute `get_performance_report` across multiple zones and campaigns, pulling combined metrics into one clean output ready for executive presentation. ## Benefits - Stop manually checking campaign status. Use `list_campaigns` to pull a full list of active and pending campaigns, confirming targeting rules instantly. - Never waste time calculating metrics by hand again. The `get_performance_report` tool delivers instant stats on impressions, clicks, and revenue for fast reporting. - Need to know where your ads are showing? Use `list_publishers` followed by `list_zones` to map out every single placement in your network. - Keep assets organized. The `list_creatives` tool gives you a current view of all banners and videos, so you never run an ad with outdated content. - Cut through the noise and find the winners or losers fast. You can quickly identify top-performing zones or failing campaigns using simple chat prompts. ## How It Works The bottom line is that you manage complex ad reporting by talking to it, not by clicking through menus. 1. Subscribe to this MCP and provide your AdButler Secret API Key. 2. Your agent uses the key to authenticate with your ad account. 3. You simply ask for a report or list data, and your agent fetches the metrics using natural language commands. ## Frequently Asked Questions **How do I get performance reports using the `get_performance_report` tool?** You must specify both a metric type (like 'impressions') and either a date range or campaign/zone criteria. The agent needs this detail to pull accurate data. **Does `list_zones` require any IDs?** Yes, absolutely. You must provide the Publisher ID first. This tool links specific placements only to a defined publisher's account. **Can I use `list_campaigns` to see if a campaign is paused?** Yes, `list_campaigns` retrieves status details for all self-serve campaigns. You can check the output list to confirm if they are active or pending. **What's the difference between listing publishers and zones?** Publishers is a list of companies/accounts managing inventory overall. Zones are specific, physical ad placements *within* one of those publisher accounts. **What credentials do I need to run `list_publishers`?** You must provide your AdButler Secret API Key. This key is required for authentication, allowing the MCP to securely access and list all publishers within your network. **Does `list_creatives` show every type of ad asset I have?** Yes, it pulls from the full library stored in AdButler. It handles listing both banner assets and video files so you can track all visual content types. **If I run `get_performance_report` for a date range with no activity, what happens?** It will accurately report zero metrics. You receive specific data showing 0 impressions and clicks, confirming the network was operational but generated no traffic during that time. **Are there usage limits when running `list_zones` for multiple publishers?** The MCP handles standard API rate limits. If you run it too frequently in a short period, your agent will pause and wait before retrying the request to prevent errors. **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.