# AdButler MCP for AI Agents AI Agent Connect > AdButler MCP lets you manage display ads, track impressions, and audit ad zones through your AI agent. It connects your ad server to your daily workflow so you can check campaign status, retrieve creative metadata, and monitor publisher inventory without switching tabs. It turns your ad server into a queryable database for faster ad ops. ## Overview - **Category:** marketing-automation - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_GJdzHBqf6HtDpeTgEhCuhUnUYS5qThH34kzH1RPY/ai-agent-connect - **Tags:** ad-server, campaign-management, impression-tracking, display-advertising, ad-ops ## Description You can now talk to your ad inventory directly. This Connector lets you treat your entire ad server as a queryable database. You can ask your agent to pull up every active campaign, check which banners are actually serving, or grab specific zone IDs for a new publisher. It takes the manual labor out of ad ops by letting your AI handle the heavy lifting of data retrieval. When you're looking for a way to organize your ad growth, Vinkius makes it easy to plug this in so you can start asking questions like 'which banners are underperforming?' or 'give me the metadata for our biggest advertiser.' It's about moving from manual clicking to conversational commands, whether you're auditing a massive portfolio or just checking if your account connection is still live. Instead of jumping between the dashboard and your spreadsheets, you get a unified way to manage your ad growth and inventory records through a single chat interface. ## Tools ### list_advertisers Get a full list of every advertiser in your account. This helps you see your entire portfolio at a glance. ### list_banners See all the banners assigned to a specific campaign. This is useful for auditing creative assets. ### list_campaigns Pull a list of all campaigns currently in your portfolio. Use this to see what is active right now. ### list_placements View all available placements across your ad server. This helps you map out your ad inventory. ### list_publishers Retrieve a list of all publishers you are currently working with. Use this to manage your network. ### list_zones Get a list of all ad zones to help map out your inventory. This is great for technical setup. ### check_adbutler_status Verify that your API connection to AdButler is active and working. This ensures your ads keep serving. ### get_advertiser Pull detailed information for a specific advertiser. Use this to quickly verify contract details. ### get_campaign Get the specific details and settings for a single campaign. This is perfect for deep dives into performance. ### get_stats Pull serving statistics for your ads to see clicks and impressions. This helps you track real-time performance. ## Prompt Examples **Prompt:** ``` List all active advertisers in my AdButler account. ``` **Response:** ``` I've pulled your advertiser list. You have 12 active profiles. The biggest ones are **Retail Giant** and **Tech Solutions**. Would you like to see the campaign details for either of these? ``` **Prompt:** ``` Show the performance for 'Banner A' from yesterday. ``` **Response:** ``` Here are the stats for **Banner A** from yesterday: * **Impressions:** 1,200 * **Clicks:** 45 * **CTR:** 3.75% I can also pull the delivery metadata if you need to see the specific placements. ``` **Prompt:** ``` Check for any campaigns expiring this week. ``` **Response:** ``` I found 2 campaigns ending this week: 1. **Summer Sale** (Ending Friday) 2. **Back to School** (Ending Wednesday) Should I pull the advertiser contact info for these so you can reach out? ``` ## Capabilities ### Pull advertiser lists Get a full list of every advertiser in your account. ### Retrieve banner assets Access the specific ad items within a campaign. ### Monitor campaign stats Check live serving statistics for your ads. ### Fetch publisher metadata Get details on all publishers in your network. ### Audit ad zone IDs Retrieve specific zone records for your inventory. ### Verify API status Confirm your account connection is active. ## Use Cases ### Checking for expiring campaigns An ops manager asks the agent to find campaigns ending this week to avoid any downtime or missed revenue. ### Auditing banner performance A publisher asks for the click-through rate of a specific banner to see if it needs a creative refresh. ### Inventory mapping A developer asks to list all zones to help build a custom internal dashboard for the sales team. ### Advertiser onboarding A manager pulls all advertiser details to verify a new contract before the campaign goes live. ## Benefits - Stop manual tab switching by using the campaign and stats tools to see your entire portfolio in one chat window. - Audit your creative assets faster by pulling banner metadata instead of clicking through deep folders. - Keep your records accurate by retrieving zone IDs and publisher data to maintain a clean inventory record. - Monitor account health instantly by verifying your connection status to ensure your ads never go dark. - Speed up reporting for clients by pulling specific advertiser details on demand without opening the dashboard. - Reduce manual errors by letting your agent handle the heavy lifting of retrieving technical metadata for your campaigns. ## How It Works The bottom line is you get a conversational interface for your entire AdButler ad server. 1. Grab your API Key from your AdButler dashboard under Settings > API Access. 2. Connect this Connector to your preferred client like Claude, Cursor, or Windsurf. 3. Ask your agent to pull campaign data, check banner stats, or list your publishers. ## Frequently Asked Questions **Can the AdButler MCP manage my ad spend?** No, this Connector is for orchestration and data retrieval. It helps you manage campaigns, pull stats, and audit inventory, but it does not handle billing or payments. **Does the AdButler MCP work with Claude?** Yes, it works with Claude, Cursor, Windsurf, and any other MCP-compatible client you prefer to use. **How do I get my API Key?** You can find your API key in your AdButler dashboard. Just go to Settings and look for the API Access section. **Can I use it to find specific banner IDs?** Yes, your agent can pull a list of all banners within a campaign so you can find the exact IDs you need. **Is it safe for my ad data?** Yes, the Connector uses your private API key to communicate with AdButler, ensuring that your data remains secure and private. **Can it track real-time impressions?** Yes, you can ask your agent to pull the latest serving statistics to see how many impressions and clicks your ads are getting. **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.