Early access to the 2027 Season Pass, 35% off.

Unlock Early Savings

How to Use the Helium 10 Get Ads Query Materials MCP Tool to Prepare Perfect Amazon Ad Queries in 2026      

Your 2027 Sellers Season Pass—Now 35% Off

Start strong with 35% off Helium 10 Diamond for 6 months, plus a $50 MCP credit, exclusive MCP skills, and early access to seller checklists. Offer ends December 6.

Get Your Offer
Your 2027 Sellers Season Pass—Now 35% Off

Start strong with 35% off Helium 10 Diamond for 6 months, plus a $50 MCP credit, exclusive MCP skills, and early access to seller checklists. Offer ends December 6.

Get Your Offer

The Helium 10 get_ads_query_materials MCP tool returns the campaign IDs, ad group IDs, ASIN lists, and targeting data you need to filter any advertising query precisely. Free to Diamond+ subscribers since July 16, 2026, it eliminates guesswork by delivering the exact reference values before you run your analysis. 

What Is the Get Ads Query Materials MCP Tool? 

The get_ads_query_materials MCP tool returns the supporting reference data — campaign IDs, ad group IDs, ASIN lists, portfolio IDs, and target lists — required to filter and scope ad queries accurately. Think of it as getting the filter values before applying filters: instead of guessing campaign names or IDs, you get the actual identifiers directly from your Helium 10 account. 

What Can You Do With Get Ads Query Materials in 2026? 

get_ads_query_materials gives you the exact identifiers needed to scope any ad query to a specific subset of your account data. This means you can: 

  • Filter campaign performance reports to a specific campaign by ID — not by name 
  • Scope keyword analysis to a single ad group using the actual ad group ID 
  • Pull ASIN-level performance data using product identifiers from your account 
  • Identify portfolio IDs to analyze branded vs. non-branded campaign performance 
  • Confirm target lists to scope placement or remarketing query filters correctly 

Combined with Helium 10 Ads for campaign management and Cerebro for competitive keyword research, you can build end-to-end analysis workflows that move from data retrieval to strategic action without leaving Claude, ChatGAP, or any AI platform you use in your workflows. 

How Does Get Ads Query Materials Work Step by Step? 

  1. Complete Steps 1–3 first. Confirm connected platforms with get_ads_query_platforms, identify your target query type with get_ads_query_list, and review the field schema with get_ads_query_schema to know which filter fields your query supports. 
  1. Ask Claude to retrieve reference data for your query type. A prompt like “Get the campaign IDs and ad group IDs I can use to filter my Sponsored Products campaign performance query” triggers get_ads_query_materials. 
  1. Review the returned reference data. Claude presents a structured list of campaigns, ad groups, ASINs, portfolios, and targets in your account — with their associated IDs — so you can identify exactly which entities to include in your query. 
  1. Select the campaigns, ad groups, or ASINs you want to analyze. If your goal is analyzing a specific product launch campaign, identify its campaign ID from the returned list. If you want a portfolio-level view, locate the correct portfolio ID. 
  1. Pass the selected IDs into your execute_ads_query prompt. Now you have the exact filter values needed to run a precisely scoped query rather than a broad account-wide report. 
  1. Save frequently used IDs for future reference. Campaign IDs for your top five campaigns, your main ad group IDs, and your hero ASIN list can be saved to a prompt template for rapid weekly reporting. 

Why Is Get Ads Query Materials Essential for Amazon Sellers in 2026? 

Without get_ads_query_materials, running a filtered ad query requires manually looking up campaign IDs in Seller Central, ad console dashboards, or spreadsheets — a fragmented, error-prone process. This tool eliminates that friction by delivering the right identifiers directly to Claude. 

Why this tool transforms ad analysis in 2026: 

  • Eliminates manual ID lookup by surfacing campaign and ad group IDs on demand 
  • Enables product-level ASIN analysis without manual data extraction 
  • Supports portfolio-level reporting for brand vs. generic campaign segmentation 
  • Reduces query scoping errors caused by incorrect or outdated campaign names 
  • Speeds up weekly reporting cycles by providing pre-confirmed filter values 

What Do Amazon Experts Say About Get Ads Query Materials? 

“The difference between a useful ad analysis and a generic one comes down to filtering. get_ads_query_materials gives you the exact IDs you need to tell Claude ‘analyze this campaign’ or ‘show me this ASIN’s performance’ — not just ‘show me everything.’ That level of precision is what turns AI into a real competitive advantage for sellers.” 

— Bradley Sutton, Chief Evangelist, Helium 10 | Amazon seller, 10+ years 

What Are the Best Use Cases for Get Ads Query Materials? 

  • Product launch campaign analysis — Retrieve campaign IDs for a new launch campaign to track its performance in isolation 
  • Portfolio segmentation — Pull portfolio IDs to compare branded vs. competitor-targeting vs. category campaign performance 
  • ASIN-level attribution — Get product ASINs to run product-specific ad attribution reports 
  • Ad group granularity — Retrieve ad group IDs to analyze keyword performance within a specific campaign structure 
  • Wasted spend investigation — Identify campaigns by ID to scope a search term report to your highest-spend campaigns 
  • Agency handoffs — Share campaign and ad group IDs with a PPC agency using a standardized, verified reference list 
  • Historical performance tracking — Use stable campaign IDs to build consistent week-over-week comparison queries

Become a Top E-Commerce Brand

Sign up now to access powerful, easy-to-use solutions to help with every part of selling on Amazon, TikTok, and Walmart.

author-photo

With seven years in marketing, Lauren writes to help e-commerce sellers grow their business with real, actionable strategies. She’s driven by helping businesses reach their goals and finds purpose in adding value to their selling journey.

Achieve More Results in Less Time

Accelerate the Growth of Your Business, Brand or Agency

Maximize your results and drive success faster with Helium 10’s full suite of Amazon and Walmart solutions.

Black Friday Early Access
35% Off
The only plan with the MCP Connector and Helium, our AI agent. Get answers on wasted ad spend, keyword gaps and listing fixes.
13DAYS
16HRS
45MIN
53SEC
Unlock Early Savings