# Walmart Connect Ads MCP MCP > Walmart Connect Ads MCP manages every aspect of your paid advertising campaigns on Walmart's platform. Adjust daily budgets, monitor real-time ROAS, and pinpoint which keywords are driving sales. It gives you hands-on control over ad spend and keyword bidding for Sponsored Search. ## Overview - **Category:** industry-titans - **Price:** Free - **Tags:** retail-media, cpc-campaigns, ad-spend, roas, keyword-bidding, marketing-analytics ## Description This connector lets you run full diagnostics on your Walmart Connect ads without touching the dashboard manually. You can list all active campaigns to see what's running and get a clear picture of performance metrics like CPC and ROAS. Need to fix something? You can adjust daily budgets or pause entire campaigns if they’re underperforming. If keyword bids are off, you can update them or even add entirely new high-potential keywords. When multiple ad groups need tweaking, your agent handles the whole sequence. Because budget is money, every call passes through a financial circuit breaker with human-in-the-loop approval; that means nothing accidentally overspends past what your team set as the maximum limit. You connect once from your preferred AI client and gain full visibility into every tool call—which tools were used, and how much of the budget was allocated. It gives you true control over ad spend across multiple platforms. ## Tools ### ads_add_keywords Adds new search terms to an ad group, setting their bid and match type (exact, phrase, or broad). ### ads_get_cpc_metrics Pulls spend, impression, and click metrics for campaigns over the last few hours. ### ads_get_keyword_performance Lists keywords and their specific historical data for the entire ad account or filtered by an ad group. ### ads_get_item_health_report Generates a comprehensive performance report snapshot of your advertising account. ### ads_create_ad_group Creates a brand new ad group inside a campaign. ### ads_list_campaigns Retrieves a list of all active Sponsored Search advertising campaigns, with optional filtering by name or ID. ### ads_pause_campaign Immediately pauses an entire active ad campaign. ### ads_update_daily_budget Changes the daily spending limit for a specified Sponsored Search campaign. ## Prompt Examples **Prompt:** ``` Analyze active Walmart Connect campaigns and list their current daily budgets. ``` **Response:** ``` Successfully queried Connect Ads. Found 3 campaigns active bounding daily constraints correctly. ``` **Prompt:** ``` Increase the bid on the exact keyword 'laptop stand' from $0.50 to $0.75 in Campaign A. ``` **Response:** ``` Operation successful. The bid for keyword 'laptop stand' has been updated to $0.75 in the targeted ad group. ``` **Prompt:** ``` Generate a performance report for all Sponsored Products over the last 30 days. ``` **Response:** ``` Report generation initiated. Extracting Cost-Per-Click statistics and total ROAS metrics for the requested 30-day window. ``` ## Capabilities ### List all campaigns Retrieves a list of all current Sponsored Search advertising campaigns for your account. ### Get performance metrics Pulls near real-time data on spending, impressions, and clicks for active ad groups or specific campaigns. ### Diagnose item health Generates a full report snapshot detailing the performance of your ads across various dimensions like keywords or categories. ### Manage daily budgets Updates the spending limit for any given Sponsored Search campaign. ### Optimize keyword bids Allows you to add new keywords, specifying their bid amount and match type (exact, phrase, or broad). ### Control ad visibility Pauses an active campaign instantly if performance drops below acceptable thresholds. ## Use Cases ### Campaign needs an immediate spending limit cut. A campaign hit its daily cap but ROAS dropped 20% yesterday. The agent first runs ads_get_keyword_performance to see the dip, then uses ads_update_daily_budget to immediately reduce the spend by 30% until the issue is resolved. ### Quarterly performance review requires a full audit. The agent runs ads_get_item_health_report for the last 90 days, gathering data on every keyword and placement type to build a complete profitability picture for stakeholders. ### New product launch needs targeted ad groups. First, the agent uses ads_create_ad_group under an existing campaign. Then, it populates that new group with highly specific keywords using ads_add_keywords to ensure tight targeting. ### Investigating poor overall account performance. Instead of guessing, the agent runs ads_list_campaigns to get a list of all campaigns. Then it calls ads_get_keyword_performance for each one to pinpoint which campaign is failing due to bad keywords. ## Benefits - You immediately know where your money is going by running the ads_get_cpc_metrics tool, which gives you near real-time spend, impressions, and clicks. - Stop wasting time manually optimizing bids. Use ads_add_keywords to quickly add new search terms with precise match types (exact, phrase, or broad) and bid amounts. - Run a full diagnostic using ads_get_item_health_report to check performance across every segment—from keywords to categories—in one report. - Need to cut losses? You can instantly pause an entire campaign with ads_pause_campaign if the ROAS drops below target, stopping spend immediately. - Avoid accidental overspending. Because this MCP runs on Vinkius, your budget adjustments are protected by a financial circuit breaker that requires human approval before any change is finalized. ## How It Works The bottom line is that it lets your AI client manage ad spend cycles end-to-end using a single set of instructions. 1. First, ask your agent to list all existing campaigns so you know exactly what needs monitoring. 2. Next, run a report using the keyword and performance data tools. This tells you which keywords are spending money without generating sales. 3. Finally, tell the agent to adjust the daily budget or increase specific bids on high-potential search terms. ## Frequently Asked Questions **How does ads_get_keyword_performance work?** It lists keywords and their performance data for your account. You can narrow down this list by campaign ID or ad group ID to see exactly what is working in a specific area. **Can I use ads_update_daily_budget on multiple campaigns at once?** Yes, you can ask your agent to iterate through multiple campaigns and apply different budget limits sequentially. It treats the entire set of changes as one managed operation. **What if a keyword needs optimizing? Do I use ads_add_keywords?** That's right. If you find a profitable search term that isn't currently bidding, you tell your agent to use ads_add_keywords, specifying the exact bid and match type needed. **Is ads_get_cpc_metrics real-time?** The data is near real-time but acknowledges a slight lag of about 1 to 3 hours. It's best for monitoring recent spending trends rather than immediate, second-by-second fluctuations. **When I use ads_list_campaigns, what security protocols are required for authentication?** The MCP handles hybrid WCPN Authentication. It combines OAuth 2.0 token generation with RSA-SHA256 request signing to meet the exact security model needed by Walmart Connect. **What specific performance data can I gather using ads_get_item_health_report?** You get a snapshot report covering many areas. Report types include adGroup, keyword, itemHealth, placement, and even attributedPurchases. You can optionally specify a date range for the results. **What details do I need to provide when I run ads_create_ad_group?** Creating an ad group requires specifying which campaign it belongs to, along with its name and budget constraints. This establishes a new container for keywords within your existing advertising structure. **If I need to immediately halt spending, how do I use ads_pause_campaign?** Running ads_pause_campaign stops the active Sponsored Search campaign instantly. The system removes it from live rotation and prevents further ad spend until you choose to reactivate it. **Can the LLM alter my product images using this MCP?** No. This MCP server targets Advertising endpoints only. To alter catalog media, use the general `walmart-marketplace-mcp`. **Can I adjust Cost-Per-Click bids dynamically?** Yes, you can monitor auction performance and instruct the agent to increase or decrease bids on specific converting keywords or ad groups natively. **Does this tool extract long-term advertising performance reports?** Absolutely. It runs async snapshot reports downloading dense ROI, ROAS, and conversion metrics directly from Walmart's ad exchange.