Table of Contents

1. Introduction
2. What Is MCP?
3. Who Should Use MCP?
4. Real-World Examples
5. What Can the Helium 10 MCP Do?
   • Keyword Research
   • Product Research
   • Rank Tracking
   • Listing Analysis
   • Profit Analytics
   • Advertising Data
   • TikTok Research
6. Full Tool Reference
7. How to Connect MCP
   • Before You Start
   • Setup Steps (Claude Connector Store — Recommended)
   • Setup Steps (ChatGPT)
   • Managing Your Connections
8. Sub-User Access to Primary Accounts via MCP
9. What MCP Can and Cannot Do
10. API Rate Limits & Optimization
11. Best Practices
12. Common Workflows & Examples
13. Frequently Asked Questions
14. Getting Help

Introduction

Welcome to Helium 10 MCP (Model Context Protocol) — your gateway to AI-powered data access for Amazon, Walmart, and TikTok Shop. MCP lets you connect your Helium 10 account directly to AI tools like Claude, ChatGPT, and Codex, enabling intelligent, real-time analysis of your seller data without ever leaving your AI assistant.

Instead of logging into Helium 10, navigating to a tool, exporting data, and pasting it into an AI — you simply ask a question in plain English and get an answer backed by live Helium 10 data.

Before MCP: Log into Helium 10 → Navigate to a tool → Export data → Paste into AI → Ask for analysis

With MCP: Connect once → Ask your AI assistant → Receive insights based on live data

What Is MCP?

MCP (Model Context Protocol) is an open standard that allows AI tools to connect securely to external data sources. Think of it as a secure bridge between Helium 10's powerful data and your favorite AI assistant.

When you ask your AI a question, here's what happens behind the scenes:

1. You ask a question — type your request in Claude, ChatGPT, Codex, or another AI tool
2. The AI reads your query — it decides which Helium 10 data tool(s) to call
3. Secure data retrieval — your Helium 10 account is authenticated via OAuth 2.0; the AI never sees your credentials
4. Data is returned — Helium 10's servers send the requested data securely
5. Analysis & response — the AI interprets the data and provides insights in plain language

Who Should Use MCP?

Real-World Examples

Here are the kinds of questions you can ask directly in your AI assistant:

Amazon-focused questions:

• "What keywords is ASIN B0XXXXXXXX ranking for right now in the US?"
• "Find high-potential products in the yoga mat category with over 500 monthly sales and less than 200 reviews."
• "Which of my products had the lowest net margin this month?"
• "Compare the keyword strategy of these three competitor ASINs."
• "Add these 20 keywords to my tracking list and remove the underperforming ones."
• "Show me my campaign performance broken down by ad group for last month. Pause campaigns with ACoS over 50%."

Walmart-focused questions:

• "What's my Walmart account profitability for the last 30 days, broken down by product?"
• "Show me my Walmart inventory levels across WFS and seller-fulfilled SKUs."
• "What's my sales velocity trend for my top 5 Walmart products over the last quarter?"

TikTok Shop-focused questions:

• "Find trending beauty products on TikTok Shop with over 100 sales in the last 7 days."
• "Search for creators in the fashion niche with 50K–200K followers and average engagement rate above 3%."
• "Which influencers are promoting a specific product? Show me their GMV and video count."

Cross-platform questions:

• "I sell on Amazon, Walmart, and TikTok. Show me my top-performing products on each platform and then find similar trending products on TikTok Shop."

What Can the Helium 10 MCP Do?

The integration covers eight major areas of seller intelligence, powered by 100 tools across 19 functional categories.

Keyword Research

Discover, expand, and score keywords for your Amazon listings and PPC campaigns. Track keyword search volume history and manage tracked keywords directly from MCP.

Product Research

Identify product opportunities and evaluate listing quality on Amazon. Search active and inactive products, compare listings, and analyze opportunities.

Rank Tracking

Monitor how your keywords and competitors' keywords perform over time. Track rank history, get suggestions, and manage your tracking list.

Listing Analysis

Evaluate Amazon listing quality and keyword coverage. Analyze reviews at ASIN, category, and niche levels to understand competitive landscape.

Profit Analytics

Understand the financial health of your business at account and product levels across Amazon and Walmart. Track P&L, inventory health, sales velocity, and cost structures. Walmart sellers now have complete P&L visibility including advertising costs and indirect operating expenses (payroll, brand fees, photography, offline promo).

Advertising Data

Query your Amazon and Walmart ad data at any level. Analyze performance and execute campaign actions directly.

TikTok Research

Discover trending products, creators, and videos on TikTok Shop. Research market trends and identify collaboration opportunities.

Helium 10 MCP: Complete Tool Reference (100 Tools)

The Helium 10 MCP integration provides 100 tools across 19 functional categories. Below is the complete reference with all tools documented.

Category 1: Keyword Research & Expansion (7 Tools)

get_keywords_by_keyword — Expand a seed keyword into a full list of related long-tail phrases. Returns search volume, CPC, IQ score, CPR, title density, and Amazon Brand Analytics data. Build comprehensive keyword banks for your listings and PPC campaigns. Discover low-competition long-tail variations of your seed keywords.

get_keywords_by_asin — Reverse-lookup any ASIN to see every keyword it ranks for organically (with rank position), via sponsored ads, and through Amazon's recommendation engine. Understand competitor keyword strategy, identify keywords you're not ranking for, and discover gaps in your competitive positioning.

compare_asin_keywords — Compare the keyword strategy of 2–3 competitor ASINs side-by-side to identify overlaps, gaps, and unique keyword opportunities. Understand which keywords drive your competitors' success and find underutilized opportunities in your niche.

analyze_keywords — Batch-score and enrich up to 200 keywords at once with comprehensive metrics: search volume, CPC, IQ score, CPR, and Amazon Brand Analytics data. Validate your keyword lists before launching PPC campaigns or optimizing listings. Score multiple keyword variations to choose the best performers.

find_keywords_with_multi_source — Build a comprehensive keyword bank by pulling keywords from multiple sources: Magnet seed expansion, Cerebro ASIN lookup, category research. Combines keywords into one deduplicated list. Create thorough keyword banks from multiple research angles to ensure comprehensive coverage for your product.

get_keywords_search_volume_history — Get keyword search volume history over time. Track how search volume for specific keywords changes day-by-day, week-by-week, or month-by-month. Understand seasonal search trends, identify peak search seasons, and validate keyword demand over time. Monitor search volume volatility to identify emerging vs declining keywords.

search_amazon_keywords — Search the Amazon keyword database to find keywords by various criteria. Access Helium 10's extensive keyword database, discover keyword opportunities, and research keyword metrics at scale. Find related keywords, analyze keyword trends, and build comprehensive keyword research datasets.

Category 2: Product Research & Sourcing (10 Tools)

search_products — Search for ACTIVE Amazon products using filters like category, price range, BSR, review count, revenue, profit margin. Find product sourcing opportunities, validate market demand, and evaluate competitor pricing and reviews. Returns top products matching your criteria with key metrics.

search_inactive_products — Search for INACTIVE or DELISTED products to understand which products failed in the market and why. Learn from failed products in your niche, understand market trends, and validate category demand before launching your own products.

search_niche_by_keyword — Use a keyword to discover the entire product niche it belongs to. Returns market size, competition level, average price, review density, and other niche metrics. Validate niche viability before entering, understand the competitive landscape, and identify market sizing information.

search_competitors_by_asin — Find all direct competitors for any ASIN within the same category/price range/review range. Shows competitor rankings, review counts, and key metrics. Identify your direct competition and benchmark their pricing, reviews, and overall performance against your products.

list_my_products — Query your OWN seller-owned products by brand, product name, ASIN, or SKU. Returns a paginated list with basic metrics: price, BSR, reviews, status. Find your ASIN when you only know the product name, organize products by brand, and build a complete product inventory for analysis.

get_listing_details — Pull the FULL listing content and metadata for any ASIN: title, bullets, description, enhanced content (A+), images, pricing, reviews, BSR, and FBA status. Audit competitor listings, extract best practices for your industry, and identify content gaps in your own listings.

get_listing_score — Get a Helium 10 listing quality audit score for any ASIN with detailed feedback on title, bullets, description, and keyword coverage. Benchmark your listing quality against competitors, identify optimization priorities, and ensure compliance before launch.

compare_listings — Compare 2–3 competitor ASINs side-by-side to identify content gaps, keyword coverage weaknesses, and feature differences. See what competitors are doing well, identify what your listing is missing, and validate your content strategy before publishing.

search_product_targets_by_asin — Find all products suitable for product targeting (Sponsored Products ads) based on a seed ASIN. Build product targeting ad lists from relevant products, discover adjacent products for cross-selling, and expand your PPC strategy with related products.

get_product_live_status — Get a real-time snapshot of an ASIN's current status: price, FBA fee, Buy Box price, stock level, review count, and BSR. Monitor competitor pricing in real-time, check your product status, and validate your pricing strategy against competition.

Category 3: Listing Builder & Content Generation (9 Tools)

generate_listing — AI-generates a complete Amazon listing (title, bullets, description, enhanced content, backend keywords) from a keyword bank or single keyword. Launch new products quickly with SEO-optimized listings, create multiple listing variations for testing, and validate your keyword strategy in listing context.

rewrite_listing_section — Rewrite ONE section of an existing listing (title, bullet, description, etc.) while maintaining keyword optimization and compliance. Improve specific listing sections that are underperforming, A/B test variations, and add keywords without losing your messaging.

retrieve_listing_by_asin — Fetch current Amazon catalog listing images, content, and metadata for an ASIN to prepare for optimization. Prepare listings for optimization work, extract current content for analysis, and validate that live catalog content matches your records.

analyze_product_images — Upload and analyze product images to extract structured attributes (color, material, size, use case, brand elements). Extract product attributes for listing generation workflows, validate image content quality, and identify missing product variations.

show_workflow_for_listing_builder — Get the entry point / orientation for Listing Builder workflows: explains available paths (keyword → listing, ASIN → rewrite, CSV import, etc.) and required inputs. Understand available Listing Builder capabilities, plan your listing generation workflow, and validate required inputs before starting.

request_image_upload_url — Request presigned S3 upload credentials to upload LOCAL image files to Helium 10. Used before image-to-listing workflows. Upload product images for listing generation, prepare images for AI analysis, and manage image assets for your listings.

sync_listing_to_amazon — DESTRUCTIVE: Push/sync listing content (title, bullets, description, A+ content) from Helium 10 directly to Amazon seller account. Updates live listing on Amazon immediately. Deploy optimized listings directly to Amazon, publish listing changes quickly without manual copy-paste, and batch-update multiple listings.

get_generated_listing_data — Retrieve previously generated or modified listing data for review or further editing. Review generated listings before publishing them live, extract metadata from generated listings, and validate content generation results before deployment.

find_keywords_with_multi_source — Build a keyword bank by pulling keywords from multiple sources (Magnet, Cerebro, category research) into one deduplicated list for listing generation. Create comprehensive keyword banks for listing generation, validate keywords from multiple research angles, and prepare for AI-powered content creation.

Category 4: Rank Tracking & Keyword Monitoring (4 Tools)

get_keywords_rank_history — Pull rank history for any keyword you're tracking, showing position over time (daily/weekly), rank changes, and trends. Monitor your keyword rank progress over time, validate that your SEO improvements are working, and identify keywords with rank volatility.

get_keywords_new_suggestion — Get NEW keyword suggestions based on your current Keyword Tracker list, showing keywords similar to what you're already tracking but not yet added. Expand your tracked keyword list systematically, discover new long-tail opportunities, and plan your rank tracking expansion.

list_tracked_keywords — Get a paginated list of ALL keywords you're currently tracking for a specific ASIN or brand, with current rank, BSR, and search volume. Audit your tracking list for gaps, identify keywords that might be missing, and validate your tracked keywords before analysis.

list_tracked_competitor_keywords — View all keywords you're tracking COMPETITORS for, with their current rank positions and tracking history. Monitor how competitor ranks change over time, identify rank stealing opportunities, and detect competitor strategy shifts as they occur.

Category 5: Profit & Loss Analytics — Amazon (8 Tools)

get_account_profit_and_loss_summary — Get a SUMMARY of your entire Amazon account's P&L for a specific time period: revenue, COGS, fees, shipping, advertising spend, and net profit. Monitor your overall account profitability, validate your pricing strategy impact on margins, and understand your cost structure.

get_account_profit_and_loss_summary_series — Get Amazon account P&L TREND DATA over time (daily/weekly/monthly): shows how revenue, costs, and profit have changed. Spot profitability trends month-over-month, understand seasonal patterns in your business, and validate pricing or cost changes over time.

get_account_profit_and_loss_breakdown — Get DETAILED P&L breakdown for entire Amazon account: breaks down revenue, costs, and profit by category, source, or other dimensions. Identify profit drains (high-fee months, high shipping costs), understand cost distribution across your products, and analyze profit by category.

get_account_profit_and_loss_breakdown_series — Get Amazon P&L BREAKDOWN TRENDS over time: shows how different cost categories and profit margins have evolved. Validate the impact of cost-reduction initiatives over time, spot seasonal cost changes, and plan quarterly cost management strategies.

get_product_profit_and_loss_summary — Get P&L SUMMARY for a SPECIFIC Amazon PRODUCT (ASIN) over a time period: revenue, costs, fees, and net profit for that product only. Evaluate individual product profitability, identify unprofitable SKUs to discontinue, and validate pricing decisions per product.

get_product_profit_and_loss_summary_series — Get P&L TREND DATA for a specific Amazon product over time: shows how a product's revenue, costs, and profit have changed day-by-day, week-by-week, or month-by-month. Monitor product profitability trends, spot pricing impact on margins, and identify seasonality patterns for specific products.

get_product_profit_and_loss_breakdown — Get DETAILED P&L breakdown for a specific Amazon product: breaks down all costs and profit components (COGS, FBA fees, advertising spend, etc.) for one ASIN. Identify product-level cost drains, understand per-unit economics, and optimize pricing by product.

get_product_profit_and_loss_breakdown_series — Get P&L breakdown TRENDS for an Amazon product: shows how different cost components for that product have changed over time. Validate product-level cost control, track impact of price increases or changes, and identify cost escalation trends.

Category 5b: Profit & Loss Analytics — Walmart (8 Tools)

NEW (September 8, 2026): Walmart P&L analytics are now structurally complete with full cost visibility including advertising costs and indirect operating expenses (payroll, brand fees, photography, offline promo).

get_wmt_account_profit_and_loss_summary — Get a SUMMARY of your entire Walmart account's P&L for a specific time period: revenue, COGS, fees, advertising spend, indirect costs, and net profit. Monitor your overall Walmart account profitability and understand your complete cost structure.

get_wmt_account_profit_and_loss_summary_series — Get Walmart account P&L TREND DATA over time (daily/weekly/monthly): shows how revenue, costs, and profit have changed. Spot Walmart profitability trends month-over-month and understand seasonal patterns in your Walmart business.

get_wmt_account_profit_and_loss_breakdown — Get DETAILED P&L breakdown for entire Walmart account: breaks down revenue, advertising costs, indirect costs, and profit by dimension. Identify profit drains and understand cost distribution across your Walmart products.

get_wmt_account_profit_and_loss_breakdown_series — Get Walmart P&L BREAKDOWN TRENDS over time: shows how different cost categories and profit margins have evolved. Validate the impact of cost-reduction initiatives and plan quarterly cost management strategies.

get_wmt_product_profit_and_loss_summary — Get P&L SUMMARY for a SPECIFIC Walmart PRODUCT over a time period: revenue, costs, advertising spend, indirect costs, and net profit for that product only. Evaluate individual Walmart product profitability and validate pricing decisions per product.

get_wmt_product_profit_and_loss_summary_series — Get P&L TREND DATA for a specific Walmart product over time: shows how a product's revenue, costs, and profit have changed. Monitor Walmart product profitability trends and identify seasonality patterns for specific products.

get_wmt_product_profit_and_loss_breakdown — Get DETAILED P&L breakdown for a specific Walmart product: breaks down all costs and profit components (COGS, advertising, indirect costs, etc.). Identify product-level cost drains and optimize pricing by product.

get_wmt_product_profit_and_loss_breakdown_series — Get Walmart P&L breakdown TRENDS for a product: shows how different cost components for that product have changed over time. Validate product-level cost control and identify cost escalation trends.

Category 6: Inventory Management & Sales Velocity (3 Tools)

get_sales_velocity — Get units SOLD over time for any product(s), bucketed by day, week, or month. Shows sales velocity trends to help forecast restock needs. Plan inventory reorders based on sales velocity, validate marketing campaign impact on sales, and identify seasonal sales patterns.

get_inventory_values — Get CURRENT inventory quantity metrics for any Amazon product(s): units in stock, fulfillment type (FBA/FBM), warehouse location, age of inventory, and estimated value. Monitor stock levels to prevent stockouts, identify overstock situations, and plan inventory adjustments.

get_fba_inventory_health_status — Get FBA inventory health metrics: days of supply, IPI score, excess inventory, stranded inventory, and aged inventory. Optimize FBA storage fees by managing inventory proactively, identify stranded/excess stock to liquidate, and prevent IPI score penalties.

Category 6b: Inventory Management — Walmart (3 Tools)

NEW (September 8, 2026): Walmart inventory management tools provide WFS and Seller Fulfilled visibility.

get_wmt_inventory_values — Get CURRENT Walmart inventory quantity metrics: units in stock by fulfillment type (WFS - Walmart Fulfillment Services and Seller Fulfilled). Monitor Walmart stock levels and plan inventory adjustments by fulfillment channel.

get_wmt_sales_velocity — Get units SOLD over time for Walmart products, bucketed by day, week, or month. Plan Walmart inventory reorders based on sales velocity and identify seasonal sales patterns for Walmart products.

get_my_wmt_seller_accounts — Discover which Walmart seller accounts are currently connected to your Helium 10 account. Returns account identifiers and connection status for each linked Walmart seller account.

Category 7: Search Query Performance & Brand Analytics (3 Tools)

get_search_query_performance — See how your listing(s) perform for REAL Amazon search queries: impressions, clicks, click-through rate, and conversions per query. Find search queries your listings aren't converting on, identify high-intent queries to target with PPC, and validate search strategy effectiveness.

search_amazon_brand_analytics — Query Amazon Brand Analytics (ABA) data: top search terms for your brand, market basket analysis, repeat purchase behavior, and demographics. Requires Diamond plan + Brand Registry. Validate brand awareness metrics, identify customer search behavior patterns, and plan product launches based on brand data.

get_brand_seller_profiles — Discover and disambiguate a Brand-Registered Amazon seller account: find their shop page, catalog size, seller rating, and sponsored brand metrics. Identify brand sellers to monitor competitively, validate brand-registered competitors, and research brand seller performance metrics.

Category 8: Advertising & Campaign Management (8 Tools)

get_ads_query_platforms — STEP 1: Get list of available ad platforms (Amazon, Walmart, etc.) and their connected profiles for querying. See which ad platforms you have connected and which are available for querying.

get_ads_query_list — STEP 2: Explore the data hierarchy for a selected platform (account → campaigns → ad groups → keywords/targets → performance metrics). Understand the structure of your ad data at different levels of granularity.

get_ads_query_schema — STEP 3: Get the schema (available fields and filters) for querying ad data at the selected granularity level. See what data fields and filtering options are available for your ad query.

get_ads_query_materials — STEP 4: Look up specific campaigns, ad groups, or keywords/targets that match your filters. Find the specific ad entities you want to analyze.

execute_ads_query — STEP 5 (TERMINAL): Execute the actual ad query with custom filters and aggregations. Returns performance data (spend, clicks, impressions, conversions, ACoS, ROAS, etc.). Get ad performance data from your connected accounts, analyze campaign ROI, identify top-performing keywords/targets, and optimize bids based on ACoS performance.

get_ads_campaign_mgmt_platforms — STEP 1 of campaign management: Get list of platforms and profiles available for MANAGING campaigns (executable actions). See which ad platforms you can manage campaigns on.

get_ads_campaign_mgmt_schema — STEP 2 of campaign management: Get the schema (available actions, fields, and constraints) for managing campaigns. Understand what campaign management actions you can perform and what parameters they accept.

execute_ads_campaign_mgmt_actions — STEP 3 (TERMINAL) of campaign management: Execute actual campaign management actions (pause/resume/create/adjust bids) on ad accounts. Pause underperforming campaigns directly, adjust keyword bids based on performance, create new campaigns, and resume campaigns after optimization.

Category 9: Alerts & Monitoring (8 Tools)

search_alert_events — Query listing change alert events for your seller account: price changes, review count changes, ranking changes, buybox changes, and other product changes. Monitor competitor activity for changes, track your product changes over time, and validate pricing automation is working correctly.

get_monitoring_status — Get your account's monitoring setup status: which products are being monitored, alert rules configured, and notification settings. Audit your monitoring setup to ensure all products are covered, identify unmonitored products, and validate alert rules are configured correctly.

get_asin_price_history — Pull PRICE HISTORY for any ASIN over time: shows how price has changed (your price + competitor prices). Monitor competitor pricing trends over time, validate your pricing strategy effectiveness, and identify how price changes impact rank.

get_asin_bsr_history — Pull BSR (Best Seller Rank) HISTORY for any ASIN: shows how rank has changed over time. Validate that marketing campaigns impact rank positively, forecast sales recovery based on historical patterns, and understand seasonal rank patterns.

get_asin_review_analysis — Get detailed REVIEW INSIGHTS for any ASIN: rating distribution, sentiment analysis, keyword extraction from reviews, common complaint themes. Identify product improvement priorities, understand customer pain points, and monitor sentiment vs competitors.

get_asin_reviews_history — Get REVIEW COUNT HISTORY for any ASIN over time: shows how reviews accumulated. Monitor review velocity over time, validate review generation campaigns are working, and forecast review growth projections.

get_category_review_analysis — Get CATEGORY-LEVEL and NICHE-LEVEL review insights: common complaint themes, sentiment trends, improvement priorities across entire category. Understand category-wide customer pain points, identify opportunities where your product can stand out, and validate market trends.

get_change_rollup — Get account-level rollup of what changed in last 24 hours or 7 days: price changes, review changes, rank movements, buybox changes, across your entire product portfolio. Monitor overall account activity for anomalies, spot significant changes quickly, and validate system updates.

Category 10: Buy Box & Seller Alerts (3 Tools)

get_buybox_summary — Get CURRENT Buy Box standing across all your monitored ASINs: which products you hold Buy Box for, losing Buy Box, and Buy Box holder details. Monitor Buy Box health across your portfolio, identify vulnerable products losing Buy Box, and validate pricing strategy impact on Buy Box.

search_buybox_history — Get BUY BOX OWNERSHIP HISTORY for any ASIN over a date range: shows who owned Buy Box when, including your account and competitors. Understand Buy Box competition history, validate pricing changes impact on Buy Box ownership, and plan pricing strategy based on historical Buy Box data.

get_seller_feedback — Get your brand/seller feedback rating and recent negative feedback summary. Tracks seller reputation metrics across your account. Monitor seller health score over time, identify service improvement priorities from feedback, and prevent account suspensions by tracking feedback.

Category 11: FBA Size Tier & Cost Optimization (1 Tool)

get_size_tier_suggestions — Get FBA size tier optimization suggestions for products: identify items that could move to a different size tier to reduce FBA fees. Reduce FBA fees through size tier optimization, validate product dimensions for tier eligibility, and plan repackaging strategies to reduce costs.

Category 12: Cost Configuration & Accounting (9 Tools)

list_amazon_cogs — Get a paginated list of ALL configured COGS (Cost of Goods Sold) records for your account. Each COGS entry tracks unit cost by product/SKU. Audit all COGS entries, validate accuracy of your cost data, and identify missing COGS entries.

create_amazon_cogs — Create a NEW COGS configuration entry: set unit cost for a product/SKU. Multiple entries per ASIN supported (e.g., different costs for different purchase dates). Add new products to COGS tracking, configure supplier cost changes, and set up cost history for margin calculation.

edit_amazon_cogs — Update an EXISTING COGS entry: change unit cost, effective date, or other COGS parameters. Update supplier costs when negotiations occur, correct COGS data errors, and track cost negotiations over time.

delete_amazon_cogs — DELETE one or more COGS records by cogs_id (batch delete supported, max 100). Remove duplicate COGS entries, clean up old or incorrect cost data, and remove products from COGS tracking when discontinued.

list_amazon_indirect_cost_settings — Get a paginated list of ALL INDIRECT COST SETTINGS (configuration rules) that you've set up: storage fees, shipping costs, returns, etc. Audit indirect cost settings, validate indirect cost configuration, and identify missing cost rules.

create_amazon_indirect_cost — Create a NEW indirect cost setting (configuration rule) for automated cost tracking: storage fees, returns processing, shipping, etc. Track FBA storage costs automatically, configure return handling costs, and monitor shipping expenses.

edit_amazon_indirect_cost — Update an EXISTING indirect cost setting: change cost formula, effective date, or calculation parameters. Update cost formulas when Amazon fees change, adjust cost allocation between products, and correct cost configuration errors.

delete_amazon_indirect_costs — DELETE one or more indirect cost settings by cost_id (batch delete supported, max 100). Remove obsolete cost rules, clean up duplicate configurations, and disable cost tracking for specific cost types.

list_amazon_indirect_costs — Get a paginated list of EXPANDED/MATERIALIZED indirect costs (actual charges calculated from settings). Shows calculated costs per day/product. Audit calculated cost charges against actual fees, validate cost formula results, and understand cost distribution.

Category 13: Account Management & User Info (3 Tools)

atlassianUserInfo — Get current user info and account permissions: email, account ID, plan level, features available, and role. Validate account permissions are correct, check plan eligibility for specific features, and confirm account setup is complete.

get_mcp_usage_info — Get your CURRENT MCP USAGE for this month: API calls used out of 1,000 monthly limit, reset date, remaining quota, and top-up status. Monitor API call usage to avoid hitting limits, plan query workload based on remaining quota, and validate account quota.

get_my_amazon_seller_accounts — Get list of all authenticated Amazon seller accounts linked to your Helium 10 account. Returns account identifiers, store names, and connection status for each linked seller account. Identify all your connected seller accounts, validate account linking, and switch between accounts for multi-account analysis.

Category 14: Advanced Keyword & Competitor Tools (2 Tools)

get_top_keywords — Get the TOP KEYWORDS for a specific listing: shows which keywords drive the most traffic, ranked by search volume and relevance. Identify keyword strengths of your listing, validate keyword strategy effectiveness, and find high-potential keywords to prioritize.

check_asin_keyword_index — Check whether an ASIN is INDEXED for specific keywords on Amazon. Returns indexed/not-indexed status per keyword. Validate keyword indexing status, identify keywords your listing isn't ranking for, and validate backend keyword optimization.

Category 15: Discovery & Category Research (1 Tool)

search_browse_nodes — Search Amazon browse nodes (category hierarchy) by category name or node ID. Useful for category-level research and filtering. Find category browse nodes for product research, validate product category classification, and explore category hierarchy structure.

Category 16: Data Download & Tool Results (1 Tool)

download_tool_result — Run an already-existing Helium 10 tool (e.g., saved Black Box query, Keyword Tracker report) and DOWNLOAD the result as a CSV or Excel file for offline analysis. Export data for offline analysis and manipulation, share reports with team members, and integrate with external tools.

Category 17: TikTok Research & Product Discovery (4 Tools)

search_tiktok_products — Search TikTok Shop products by keyword, brand, category, price, rating, shipping, listing recency, units sold, GMV, GMV trend, commission rate, and affiliate/video engagement ranges. Returns sales metrics, affiliate share, active/new creator and video counts. Find trending products to study, identify product sourcing opportunities, research competitor product performance, validate product demand. Up to 500 products per query; US marketplace only; 10–100 results per call.

search_tiktok_influencers — Search TikTok creators by keyword, category, follower count, follower age/gender, engagement rates (video and live), GMV band, units-sold band, commission band, and AOV. Returns follower data, performance metrics, engagement rates. Find creators in your niche to analyze, research creator demographics and performance, identify collaboration opportunities. Up to 1,000 creators per query; US marketplace only; 10–100 results per call.

get_tiktok_product_influencers — Given a product ID from search_tiktok_products, get all creators promoting or selling that specific product (Collaborating Influencers) with their GMV, units sold, and video count for that product. Returns creator performance data specific to that product. Understand which influencers drive sales for specific products, identify top collaborators for each product, build product-specific creator lists, evaluate influencer performance per product. Up to 500 creators per query; US marketplace only.

search_tiktok_hot_videos — Search trending TikTok Shop videos by keyword, category, and time window (7/14/30 days). Returns each video with the product it promotes, the creator who posted it, and engagement/sales metrics (views, likes, shares, comments, engagement rate, GMV, units sold). Discover trending video content and formats, identify viral products and creators, research what resonates with TikTok audiences. Up to 500 videos per query; US marketplace only; 10–100 results per call.

Category 18: Keyword Tracker — Write Functions (3 Tools)

add_untracked_product_keywords — ADD new keywords to your Keyword Tracker for a specific product (ASIN). Batch-add multiple keywords at once. Specify Product ASIN, list of keywords to track, and marketplace. Returns confirmation of added keywords and tracking status. Add keyword opportunities discovered through competitive analysis, expand tracking for products based on AI insights, automate keyword tracker updates from MCP analysis.

delete_tracked_keywords — REMOVE specific keywords from your Keyword Tracker for a product. Batch-delete supported (up to 100 at once). Specify Product ASIN, list of keywords to remove, and marketplace. Returns confirmation of deleted keywords. Remove underperforming keywords from tracking, clean up tracker to focus on high-potential keywords, optimize your tracked keyword list.

delete_tracked_product — REMOVE an entire product from your Keyword Tracker. This stops all rank tracking for that ASIN. Specify Product ASIN and marketplace. Returns confirmation of product removal and all associated keywords deleted. Stop tracking inactive or delisted products, clean up tracker for discontinued products, reorganize your tracking portfolio.

Category 19: Market Tracker & Category Research (3 Tools)

list_user_markets — List all Helium 10 Market Tracker 360 (MT360) markets for your authenticated account. Returns available markets and their configurations. Identify which markets you have access to for analysis, understand your market tracking setup, and validate account market coverage.

get_market_overall — Get overall Market Tracker 360 historical series (optional compare) for one MT360 market. Returns overall market performance data over time: market size, growth trends, competitive landscape changes. Monitor overall market trends and growth, validate market positioning over time, forecast market maturity and opportunities.

get_market_statistics — Get headline Market Performance statistics for one MT360 market: your share, market share by category, competitive metrics, performance indicators. Understand your market position vs competitors, identify market share opportunities, validate competitive standing in your market.

Tool Summary Table

MCP Input Handling Improvements (September 8, 2026)

MCP input handling is now more forgiving and flexible:

• Array parameters like marketplace now accept a single value — No need to wrap single values in an array; the system automatically handles both single values and arrays.
• End dates past today are clamped to today — Instead of returning an error when you specify an end date in the future, the system automatically adjusts it to today's date.

These improvements make MCP more intuitive to use and reduce common error scenarios.

How to Connect MCP

Before You Start

• Helium 10 Diamond plan or higher
• A supported AI tool: Claude (Web or Desktop), ChatGPT, or Codex

Setup Steps (Claude Connector Store — Recommended)

1. Open your AI tool settings: Claude Web → Customize → Connectors; Claude Desktop → Customize → Connectors
2. Click Add → Browse Connectors
3. Search for "Helium 10" in available connectors
4. Click Connect to initiate the connection
5. Authorize in browser — enter your Helium 10 credentials
6. Choose the appropriate account and click Continue to approve

Setup Steps (ChatGPT)

1. Open ChatGPT and sign in
2. Click Settings in the bottom-left corner
3. Go back to Plugins → Browse Plugins
4. At the top right, search for "Helium 10"
5. Click "Install plugin" at the top right
6. ChatGPT will show a Connect or Authorize prompt for Helium 10 MCP
7. Complete the Helium 10 login and authorization in your browser
8. Return to ChatGPT once authorization finishes
9. Test the connection: Ask "Use Helium 10 MCP to analyze keywords for an Amazon ASIN." If it returns data, you're connected

Note: Codex App users should follow ChatGPT steps and install the plugin using ChatGPT store.

Managing Your Connections

Helium 10 → Settings → MCP → Authorized AI Clients Management

Sub-User Access to Primary Accounts via MCP

Sub-users can access a primary Helium 10 account via MCP if the primary account owner grants them access.

Step 1: Primary Account Owner Adds Sub-User & Grants MCP Permission

1. Log in to your Helium 10 account
2. Click your account icon (top-right) and select Access Management
3. Click + ADD NEW USER and enter the sub-user's email
4. The sub-user receives an activation email
5. Go to Access Management → User Accounts
6. Click the pencil icon next to the sub-user's name
7. Check the box next to MCP (and any other tools)
8. Click Confirm

Step 2: Sub-User Connects MCP to AI Tools

1. Open your AI tool settings (Claude, ChatGPT, or Codex)
2. Search for and select Helium 10 MCP
3. Click Connect and complete the OAuth authorization
4. Choose the primary account you've been granted access to
5. Authorize the connection

Step 3: Sub-User Sets Default Account (Optional)

1. Log in to Helium 10 with your sub-user account
2. Open Settings
3. Click Change Default Account (top-right)
4. Select the primary account
5. You'll now automatically log into the primary account

Key Requirements:

• Primary account must be on Helium 10 Diamond plan or higher
• MCP permission must be explicitly granted by the primary account owner
• Sub-user must use the same email for their Helium 10 account and AI tool OAuth login

What MCP Can and Cannot Do

✅ What You CAN Do with Helium 10 MCP

• Read all your Helium 10 data (read-only for most tools, selective write access for specific tools)
• Query Amazon and TikTok Shop data
• Query Walmart P&L, inventory, and sales velocity data
• Query at any granularity (account-level, product-level, time-series, breakdowns, trends)
• Combine tools intelligently for comprehensive analysis
• Support all Amazon marketplaces (US, UK, DE, JP, CA, AU, FR, ES, IT, NL, PL, SE, MX), Walmart (US), and TikTok Shop (US)
• Access real-time ad data and query at any level of granularity
• Manage cost tracking (create and edit COGS and indirect costs)
• Manage keyword tracking (add and remove tracked keywords and products)
• Execute campaign actions (pause, resume, create, adjust Amazon ad campaigns)

❌ What You CANNOT Do (Current Release)

• Query multiple accounts simultaneously (each connection = one account; separate connections needed per account)
• Write to Seller Central, Walmart Seller Center, or TikTok Shop directly (most writes must happen in Helium 10 or platform UI)
• Get real-time data (data refreshes periodically, 5–15 second response times)
• Take TikTok Shop actions (send creator invites, manage affiliate signups, modify product/creator data)

API Rate Limits & Optimization

Monthly Rate Limits

• Included Quota: 1,000 API calls/month (included with Diamond+ plan)
• Reset Date: First day of billing cycle
• Cost Per Call: 1 call per tool invocation (pagination counts as additional calls)
• Top-Up Option: $50 for 500 additional API calls per month — Available now. Purchase via Helium 10 subscription management page. Pro-rated allocation — Calls are allocated proportionally based on remaining days in the billing cycle at time of purchase. For example, if you purchase a top-up pack on day 15 of a 30-day billing cycle, you'll receive a proportional allocation of the 500 calls for those remaining 15 days. If you have a yearly or Enterprise subscription, please contact support to assist adding this to your account.

Tips for Optimal Usage

• Batch queries with filters to get only needed data
• Combine multiple tools in one conversation to reuse earlier results
• Simple queries: 1–2 API calls | Comprehensive reports: 5–10 calls
• Avoid redundant lookups — reference earlier results instead of re-querying
• Use list_my_products first when you don't have an ASIN handy
• Use get_my_wmt_seller_accounts to discover connected Walmart accounts
• For TikTok queries, filter by category, time window (7/14/30 days), or performance band
• Batch add/remove keywords to reduce API calls
• Test campaign actions on small sets before scaling

Common Workflows & Examples

Workflow 1: Launch a Competitive Amazon Listing

1. Find market opportunities (search_products)
2. Validate niche viability (search_niche_by_keyword)
3. Find direct competitors (search_competitors_by_asin)
4. Extract competitor content (get_listing_details)
5. Compare strategies (compare_listings)
6. Score keyword list (analyze_keywords)
7. Generate optimized listing (generate_listing)

Workflow 2: Discover Keywords Across Multiple Research Methods

1. Search Amazon keyword database (search_amazon_keywords)
2. Expand seed keywords (get_keywords_by_keyword)
3. Track keyword search volume history (get_keywords_search_volume_history)
4. Analyze search trends and seasonality (get_keywords_search_volume_history)
5. Combine all keywords (find_keywords_with_multi_source)
6. Score combined list (analyze_keywords)

Workflow 3: Plan and Execute Amazon PPC Campaign

1. Get current keywords your ASIN ranks for (get_keywords_by_asin)
2. Score the keyword list (analyze_keywords)
3. Check search performance (get_search_query_performance)
4. Query current campaign performance (execute_ads_query)
5. Pause underperformers and adjust bids (execute_ads_campaign_mgmt_actions)

Workflow 4: Manage Keyword Tracker Dynamically

1. Discover competitor keywords (get_keywords_by_asin)
2. Score them for viability (analyze_keywords)
3. Add promising keywords to track (add_untracked_product_keywords)
4. Review updated tracking list (list_tracked_keywords)
5. Remove underperforming keywords (delete_tracked_keywords)

Workflow 5: Analyze Walmart Profitability (NEW)

1. Get Walmart account P&L summary (get_wmt_account_profit_and_loss_summary)
2. Break down costs by product (get_wmt_product_profit_and_loss_breakdown)
3. Review P&L trends over time (get_wmt_account_profit_and_loss_summary_series)
4. Monitor inventory levels (get_wmt_inventory_values)
5. Track sales velocity (get_wmt_sales_velocity)

Workflow 6: Discover Trending Products on TikTok Shop

1. Find trending videos in your category (search_tiktok_hot_videos, sort by GMV)
2. Extract product info and search for those products (search_tiktok_products)
3. Identify creators promoting those products (get_tiktok_product_influencers)
4. Analyze trends to validate genuineness and identify which creators drive sales

Best Practices

Writing Good Prompts

• Be specific: ❌ "Find keywords" → ✅ "Find keywords that ASIN B0XXXXXXXX is ranking for in the US"
• Always use ASINs for Amazon queries — Use 10-character identifier (e.g., B0XXXXXXXX), not SKU/UPC/EAN/GTIN
• Specify marketplace for Amazon queries — Default is US; say "UK marketplace" or "Amazon Germany" when needed
• For Walmart queries, specify which seller account — Use get_my_wmt_seller_accounts first if you're unsure
• For TikTok, use natural language categories — ✅ "beauty" or "fashion" (system auto-maps to taxonomy)
• Combine tools in one request — Ask Claude to pull multiple tools and synthesize insights
• Ask for interpretation, not just data — Claude can explain meaning, suggest next steps, highlight risks
• Use follow-up questions — Claude retains context; ask "Now show me rank history for the top 5 keywords"
• Use list_my_products first — When you don't have an ASIN, find it by product name or brand
• Avoid low-cost models — Use Sonnet or Opus; avoid Haiku or Instant

Performance Tips

• Keep queries specific to reduce response time
• Only request needed fields and timeframes
• Space out large queries to avoid hitting monthly limits
• Simple queries: 2–5 seconds | Complex reports: 5–15 seconds
• Split batch keyword analysis larger than 200 keywords
• For Walmart, start with account-level summary before drilling into products
• For TikTok, filter by category, time window, or performance band
• Batch add/remove keywords to reduce calls
• Test campaign actions on small sets before scaling

Frequently Asked Questions

Do I need to be technical to connect Helium 10 MCP? No. Setup is straightforward via OAuth. The entire process takes just a few minutes.

Is MCP included in my plan? Yes. MCP is free for all Helium 10 Diamond plan members and above. Top-up packs are available separately.

Which AI tools support MCP? Any MCP-compatible client works. Currently tested and supported: Claude (Web & Desktop), ChatGPT, and Codex.

Which Amazon marketplaces are supported? All Amazon marketplaces available in your account: US, UK, Germany, Japan, Canada, Australia, France, Spain, Italy, Netherlands, Poland, Sweden, Mexico.

Are Walmart and TikTok Shop supported? Walmart P&L, inventory, and sales velocity tools are now available (US marketplace). TikTok Shop research tools support US marketplace only. International support may be added in the future.

What's the MCP Top-up option? $50 for 500 additional API calls per month — Available now. Purchase via Helium 10 subscription management page. Pro-rated allocation — Calls are allocated proportionally based on remaining days in the billing cycle at time of purchase. For example, if you purchase a top-up pack on day 15 of a 30-day billing cycle, you'll receive a proportional allocation of the 500 calls for those remaining 15 days. If you have a yearly or Enterprise subscription, please contact support to assist adding this to your account.

How many API calls does one question use? Simple queries use 1–2 calls; comprehensive reports use 5–10 calls. Your 1,000 monthly calls typically support 500–1,000 conversations depending on scope. This is a shared quota between the main account and all sub-user account(s).

Can I buy a top-up pack before my allowance runs out? Yes. Top-up packs are available for purchase. Your call allowance resets automatically each month. If you have a yearly or Enterprise subscription, please contact support to assist adding this to your account.

Can MCP make changes to my listings or campaigns? Yes, selectively. Keyword Tracker write functions let you manage tracked keywords. Ads Campaign Management lets you manage campaigns.

Can I see all my linked Amazon seller accounts? Yes. Use get_my_amazon_seller_accounts to get a list of all authenticated Amazon seller accounts linked to your Helium 10 account.

Can I see all my linked Walmart seller accounts? Yes. Use get_my_wmt_seller_accounts to discover which Walmart sellers are connected to your Helium 10 account.

Can I track keyword search volume trends? Yes. Use get_keywords_search_volume_history to see how search volume for specific keywords changes over time. Understand seasonal trends and identify emerging vs declining keywords.

Can I search the Amazon keyword database? Yes. Use search_amazon_keywords to access Helium 10's extensive keyword database. Discover keywords at scale and research keyword opportunities.

Can I analyze Walmart profitability? Yes. Walmart P&L tools now provide complete profitability visibility including advertising costs and indirect operating expenses. Use the get_wmt_account_profit_and_loss_summary and product-level P&L tools to analyze Walmart profitability.

My MCP connection stopped working. How do I fix it? Disconnect and reconnect to refresh your OAuth token. Go to Helium 10 → Settings → MCP → Authorized AI Clients Management.

Why am I getting the error "FEATURE.ADS_ACCESS_DISABLED"? Error message "FEATURE.ADS_ACCESS_DISABLED" indicates that your Helium 10 account does not have an actively managed Ads account. Helium 10 Ads features require your Amazon Ads profile to be set to "Managed" mode in order to access and manage your Ads data through Helium 10.

• To resolve this error:

1. Visit your Helium 10 Ads Settings page
2. Locate your Ads profile and change it from "Disable" or "Analytics-only" to "Managed"
3. Save your changes
4. Retry your Ads action in Helium 10

• Important Billing Note: Profiles in "Managed" mode will incur a 2% fee on all advertising spend. This fee applies even if no automated actions are taken. Please review your budget and usage before enabling Managed mode. For more detailed guidance on Helium 10 Ads modes and settings, visit the Helium 10 Ads Settings article.

What if Claude returns no results? ASIN/product wasn't found, marketplace unsupported, or connectivity issue. Try rephrasing, specifying marketplace explicitly, or verifying ASIN format (10 characters).

What does "GMV" mean in TikTok tools? GMV = Gross Merchandise Value — total revenue generated by influencers/products/videos on TikTok Shop during the selected time window.

Getting Help

• Helium 10 Support: kb.helium10.com or Contact Support
• Claude Support: support.claude.com
• Manage MCP Connections: Helium 10 → Settings → MCP → Authorized AI Clients Management