# Nuviad Advertising MCP > Nuviad Advertising connects your programmatic ad account directly to your AI agent. Use this server to manage real-time bidding (RTB) campaigns, list active creatives, check campaign performance, and retrieve detailed reports via natural conversation. Stop logging into the portal; just ask for the data. ## Overview - **Category:** marketing-automation - **Price:** Free - **Tags:** programmatic-advertising, rtb, mobile-ads, campaign-management, ad-creatives, performance-reporting ## Description Listen up. Nuviad Advertising connects your programmatic ad account straight to your AI agent. You'll use this server to manage everything—from real-time bidding (RTB) campaigns to active creatives and detailed reports—using plain conversation. Forget logging into the portal; you just ask for the data. This tool gives your agent access to every core campaign function: checking running ads, managing targeting lists, reviewing performance metrics, and retrieving deep report content. It's built for Ad Ops Managers who need answers fast and don't have time to dig through a dashboard. When you use this server, your AI client can list all currently active and paused mobile ad campaigns using `list_campaigns`. You can then check the specific audience groups and targeting lists configured for those ads with one call; it’ll pull everything from general audience groups down to device ID blacklists and whitelists via `list_targeting_lists`. Need to know how much money you're spending? Your agent retrieves the exact micro-bid values set across various campaigns or exchanges using `list_micro_bids`, plus it lists margin adjustments applied at the site level through `list_micro_margins`. For campaign assets, your AI client fetches the complete library of available ad materials—banners, videos, and native ads—using `list_creatives`. If you need to adjust where those ads run, it even lists all specific geographic regions and coordinates that can be used for targeting via `list_geo_locations`. When it comes to performance tracking, the agent handles the whole process. You can first request a detailed, custom report for any specified campaign period using `request_campaign_report`. To get an immediate overview of how campaigns performed over a selected time window, you just ask for the summary; that’s handled by `get_reports_summary`. Once you've run the report, your agent lets you monitor its progress. It checks the current status of any requested campaign performance report using `get_report_status`, and when it's ready, you pull the final data content directly with `get_report_content`. You get the whole cycle done without lifting a finger. ## Tools ### get_reports_summary Generates a high-level summary of overall campaign performance metrics. ### list_geo_locations Lists all specific geographic regions and coordinates that can be used for targeting. ### get_report_content Retrieves the final data content for a report that has already been generated. ### get_report_status Checks and reports on the current status of any requested campaign performance report. ### list_creatives Fetches the complete library of available ad assets (banners, videos, etc.). ### list_campaigns Returns a list containing all currently active and paused mobile ad campaigns. ### list_micro_bids Retrieves the defined micro-bid values set for various campaigns or exchanges. ### list_micro_margins Lists the margin adjustments applied to campaign spending at the site level. ### list_targeting_lists Provides a list of all audience and targeting groups configured for campaigns. ### request_campaign_report Starts the process to generate a detailed, custom report for a specified campaign period. ## Prompt Examples **Prompt:** ``` List all my active mobile ad campaigns. ``` **Response:** ``` Retrieving campaigns... I found 5 active campaigns including 'Summer Promo 2024', 'Brand Awareness US', and 'App Install Growth'. Would you like the performance summary for the Summer Promo? ``` **Prompt:** ``` Request a performance report for campaign ID 'cmp_98765' for the last 7 days. ``` **Response:** ``` Report request initiated... The request for campaign cmp_98765 has been submitted (ID: req_12345). I'll check the status for you. It usually takes a few minutes to generate. ``` **Prompt:** ``` Show me the list of ad creatives in my account. ``` **Response:** ``` Fetching ad creatives... You have 12 assets registered: 8 'Banner' images, 2 'Video' ads, and 2 'Native' components. Shall I list the specific Image Keys for the banners? ``` ## Capabilities ### List active campaigns The agent pulls a list of all running and paused mobile ad campaigns in your account. ### Retrieve performance summaries You get an immediate summary of how specific campaigns performed over a selected time window. ### Manage campaign reports The agent submits a report request and can then monitor its status or retrieve the final, detailed content. ### Check targeting lists List all audience groups, including device ID blacklists and whitelists, for compliance checks. ### Review micro-bidding data The agent retrieves the exact micro-bid values and margin adjustments applied at the exchange or site level. ### Inspect ad creatives List all current banner, video, and native assets available for campaign deployment. ## Use Cases ### Checking a stalled campaign's performance A growth team member notices an ad campaign isn't performing well. They ask their agent to first `list_campaigns` to confirm the ID, then run `get_reports_summary` for that ID and date range. Finally, they use `get_report_content` if a deeper dive is needed, all without touching the Nuviad UI. ### Auditing bidding strategy across regions A strategist wants to know if their margin adjustments are consistent globally. They first run `list_geo_locations` to see available markets, then use that list with `list_micro_margins` to get a global view of the current bid rules. ### Preparing quarterly performance deep dive A marketing analyst needs raw data for 10 campaigns. They run `request_campaign_report` for all ten, collect the job IDs, and then monitor every single one using `get_report_status` until they can pull the final results via `get_report_content`. ### Onboarding a new ad creative An Ad Ops Manager needs to confirm all assets are ready for a new campaign. They first call `list_creatives` to see what's available, then use `list_targeting_lists` to make sure the proper audience groups exist before starting any bids. ## Benefits - **Instant Campaign Status.** Instead of opening the Nuviad portal, ask your agent to `list_campaigns`. You get an immediate list of all active campaigns and their current status. It saves clicks and time. - **Automated Report Generation.** Need data for last quarter? Use `request_campaign_report`. The agent submits the request, giving you a job ID, and then you can check its progress with `get_report_status` until it's ready. - **Granular Bidding Visibility.** You don’t have to guess your profitability. Call `list_micro_bids` or `list_micro_margins` to pull the exact bid adjustments used at the exchange level for optimization checks. - **Comprehensive Asset Review.** Quickly check if you've run out of material by using `list_creatives`. You get a count and breakdown of all banner, video, and native ads ready to go. - **Targeting Compliance Check.** Use `list_targeting_lists` to verify which audience groups are active. This is critical for ensuring your campaigns hit the right users without manual list checks. ## How It Works The bottom line is: You talk to your agent like talking to an ad manager—no API knowledge needed. 1. First, subscribe to the Nuviad Advertising server and input your API Bearer Token. 2. Next, prompt your AI agent with a task (e.g., 'List all campaigns'). 3. The agent executes the required tool calls, pulls data from Nuviad, and presents you with the final answer. ## Frequently Asked Questions **How do I check if my report request using `request_campaign_report` is finished?** You use the `get_report_status` tool. This checks the job ID you received from the initial request and tells you if it's 'Pending,' 'Running,' or 'Complete.' It doesn't pull the data, just the status. **What is the difference between `get_reports_summary` and `get_report_content`?** `get_reports_summary` provides a quick, high-level overview. Use `get_report_content` only *after* you've successfully requested and confirmed the status of a detailed report using the proper job ID. **Can I list all available ad creatives with `list_creatives`?** Yes. This tool fetches your entire library of assets, including banners, videos, and native components, so you can confirm what materials are ready for the next campaign launch. **How do I check my available audience lists using `list_targeting_lists`?** Just prompt your agent to run `list_targeting_lists`. It pulls all configured audience and targeting groups, letting you verify that the correct segments are active for bidding. **I need a performance report for last week. Do I use `request_campaign_report`?** Yes, run `request_campaign_report`. You must specify the campaign ID and the date range you want to analyze in your prompt. **What credentials do I need before running the `list_campaigns` tool?** You must provide a valid Nuviad Bearer Token. This API key authenticates your connection to our system and authorizes your AI client to access campaign data. Without it, any attempt to use the tool will fail with an authorization error. **When I run `list_micro_bids`, what exactly are these values?** The list shows micro-bids—the smallest currency unit for bidding at the exchange or site level. These figures determine how much your ad campaign is willing to pay per impression or click, giving you granular control over spending. **Does the `list_geo_locations` tool handle large datasets efficiently?** Yes, the tool implements pagination for location data. If the total number of available locations exceeds a standard page limit, your AI agent will request subsequent pages until all geographic options are collected. **How do I get a Nuviad API Key?** You can find or generate your API Key in your Nuviad account dashboard. It is usually passed as a Bearer Token in the Authorization header. **Can I download report data directly?** Yes! The `get_report_content` tool allows you to retrieve the actual data for a completed report request directly through the agent. **What are micro-bids in Nuviad?** Micro-bids allow you to adjust your bidding strategy at a very granular level, such as for specific ad exchanges or publisher sites, to optimize campaign ROI.