Getting Started with Helium 10 MCP

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?
6. Complete Tool Reference (118 Tools)
7. How to Connect MCP
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 tag them as 'high-priority'."
• "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?"
• "Compare my COGS and indirect costs between two supplier relationships."

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 nine major areas of seller intelligence, powered by 118 tools across 22 functional categories.

Keyword Research

Discover, expand, and score keywords for your Amazon listings and PPC campaigns. Track keyword search volume history, discover trends, 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 with tags and notes.

Listing Analysis

Evaluate Amazon listing quality and keyword coverage. Analyze reviews at ASIN, category, and niche levels to understand competitive landscape. Generate new listings powered by AI.

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).

Account Monitoring

Monitor your seller account health, track listing changes in real-time, and receive alerts for price, rank, and review changes. Monitor competitor activity and validate your pricing automation.

Advertising Data & Automation

Query your Amazon and Walmart ad data at any level. Analyze performance, execute campaign actions directly, build automation rules by conversation, and track all changes to your campaigns.

TikTok Research

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

Market Intelligence

Access Market Tracker 360 data for category-level competitive analysis, market size trends, and your market positioning. Available for users with MT360 add-on.

Complete Tool Reference (116 Tools)

The Helium 10 MCP integration provides 118 tools across 22 functional categories.

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.

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 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.

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.

find_keywords_with_multi_source — Build a comprehensive keyword bank by pulling keywords from multiple sources: Magnet seed expansion, Cerebro ASIN lookup, category research.

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.

search_amazon_keywords — Search the Amazon keyword database to find keywords by various criteria. Discover keyword opportunities and research keyword metrics at scale.

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 and validate market demand.

search_inactive_products — Search for INACTIVE or DELISTED products to understand which products failed in the market and why.

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.

search_competitors_by_asin — Find all direct competitors for any ASIN within the same category/price range/review range.

list_my_products — Query your OWN seller-owned products by brand, product name, ASIN, or SKU.

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.

get_listing_score — Get a Helium 10 listing quality audit score for any ASIN with detailed feedback on title, bullets, description, and keyword coverage.

compare_listings — Compare 2–3 competitor ASINs side-by-side to identify content gaps and keyword coverage weaknesses.

search_product_targets_by_asin — Find all products suitable for product targeting (Sponsored Products ads) based on a seed ASIN.

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.

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

generate_listing — AI-generates a complete Amazon listing (title, bullets, description, enhanced content, backend keywords) from a keyword bank or single keyword.

rewrite_listing_section — Rewrite ONE section of an existing listing (title, bullet, description, etc.) while maintaining keyword optimization and compliance.

retrieve_listing_by_asin — Fetch current Amazon catalog listing images, content, and metadata for an ASIN to prepare for optimization.

analyze_product_images — Upload and analyze product images to extract structured attributes (color, material, size, use case, brand elements).

request_image_upload_url — Request presigned S3 upload credentials to upload LOCAL image files to Helium 10.

sync_listing_to_amazon — DESTRUCTIVE: Push/sync listing content (title, bullets, description, A+ content) from Helium 10 directly to Amazon seller account.

find_keywords_with_multi_source — Build a keyword bank by pulling keywords from multiple sources into one deduplicated list for listing generation.

get_keyword_performance_with_competitors — Scores how well a keyword set is written into listings, based on competitor analysis.

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.

get_keywords_new_suggestion — Get NEW keyword suggestions based on your current Keyword Tracker list.

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.

list_tracked_competitor_keywords — View all keywords you're tracking COMPETITORS for, with their current rank positions and tracking history.

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.

get_account_profit_and_loss_summary_series — Get Amazon account P&L TREND DATA over time (daily/weekly/monthly).

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.

get_account_profit_and_loss_breakdown_series — Get Amazon P&L BREAKDOWN TRENDS over time.

get_product_profit_and_loss_summary — Get P&L SUMMARY for a SPECIFIC Amazon PRODUCT (ASIN) over a time period.

get_product_profit_and_loss_summary_series — Get P&L TREND DATA for a specific Amazon product over time.

get_product_profit_and_loss_breakdown — Get DETAILED P&L breakdown for a specific Amazon product: breaks down all costs and profit components.

get_product_profit_and_loss_breakdown_series — Get P&L breakdown TRENDS for an Amazon product over time.

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

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.

get_wmt_account_profit_and_loss_summary_series — Get Walmart account P&L TREND DATA over time.

get_wmt_account_profit_and_loss_breakdown — Get DETAILED P&L breakdown for entire Walmart account.

get_wmt_account_profit_and_loss_breakdown_series — Get Walmart P&L BREAKDOWN TRENDS over time.

get_wmt_product_profit_and_loss_summary — Get P&L SUMMARY for a SPECIFIC Walmart PRODUCT over a time period.

get_wmt_product_profit_and_loss_summary_series — Get P&L TREND DATA for a specific Walmart product over time.

get_wmt_product_profit_and_loss_breakdown — Get DETAILED P&L breakdown for a specific Walmart product.

get_wmt_product_profit_and_loss_breakdown_series — Get Walmart P&L breakdown TRENDS for a product over time.

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.

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.

get_fba_inventory_health_status — Get FBA inventory health metrics: days of supply, IPI score, excess inventory, stranded inventory, and aged inventory.

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

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

get_wmt_sales_velocity — Get units SOLD over time for Walmart products, bucketed by day, week, or month.

get_my_wmt_seller_accounts — Discover which Walmart seller accounts are currently connected to your Helium 10 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.

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.

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.

Category 8: Advertising & Campaign Management (13 Tools)

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

get_ads_query_list — STEP 2: Explore the data hierarchy for a selected platform (account → campaigns → ad groups → keywords/targets → performance metrics).

get_ads_query_schema — STEP 3: Get the schema (available fields and filters) for querying ad data at the selected granularity level.

get_ads_query_materials — STEP 4: Look up specific campaigns, ad groups, or keywords/targets that match your filters.

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_ads_campaign_mgmt_platforms — STEP 1 of campaign management: Get list of platforms and profiles available for MANAGING campaigns.

get_ads_campaign_mgmt_schema — STEP 2 of campaign management: Get the schema (available actions, fields, and constraints) for managing campaigns.

execute_ads_campaign_mgmt_actions — STEP 3 (TERMINAL) of campaign management: Execute actual campaign management actions (pause/resume/create/adjust bids) on ad accounts.

get_ads_rule_platforms — STEP 1 of Ads Rules: Get list of available ad platforms and profiles for building automation rules.

get_ads_rule_schema — STEP 2 of Ads Rules: Get the schema for building automation rules, including available metrics, bid actions, guardrails, and schedules.

manage_ads_rule — STEP 3 (TERMINAL) of Ads Rules: Build, edit, and manage Amazon Bid Rules automation in plain English. Draft-first and approval-gated — nothing goes live until you explicitly confirm.

get_ads_changelog_platforms — STEP 1 of Change Log: Get list of available ad platforms (Amazon, Walmart) for querying change history.

get_ads_changelog_schema — STEP 2 of Change Log: Get the schema for change log queries, including available change types and filters.

execute_ads_changelog_query — STEP 3 (TERMINAL) of Change Log: Query all bid, budget, keyword, negative, campaign status, and placement changes with old value, new value, who made it, and when. Filterable by actor: rules, schedules, AI bidding, MCP/agent, manual H10 edits, or external Seller Central changes.

Category 9: Seller Account Health & Real-Time Monitoring (9 Tools)

get_seller_account_health — Get account-level health metrics for connected Amazon seller accounts: account standing, feedback rating, suspension risks, and overall health status.

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.

get_monitoring_status — Get your account's monitoring setup status: which products are being monitored, alert rules configured, and notification settings.

search_b2b_offer_change_notifications — Search B2B Any Offer Changed notification events: track when offers on your products change from B2B buyers.

search_fee_promotion_notifications — Search fee and promotion notification events: track Amazon fee changes, promotion eligibility, and cost-related updates.

get_asin_price_history — Pull PRICE HISTORY for any ASIN over time: shows how price has changed (your price + competitor prices).

get_asin_bsr_history — Pull BSR (Best Seller Rank) HISTORY for any ASIN: shows how rank has changed over time.

get_asin_reviews_history — Get REVIEW COUNT HISTORY for any ASIN over time.

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.

Category 10: Review Analysis & Customer Insights (3 Tools)

get_asin_review_analysis — Get detailed REVIEW INSIGHTS for any ASIN: rating distribution, sentiment analysis, keyword extraction from reviews, common complaint themes.

get_category_review_analysis — Get CATEGORY-LEVEL and NICHE-LEVEL review insights: common complaint themes, sentiment trends, improvement priorities across entire category.

search_browse_nodes — Search Amazon browse nodes (category hierarchy) by category name or node ID. Useful for category-level research and filtering.

Category 11: Buy Box & Seller Reputation (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.

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.

get_seller_feedback — Get your brand/seller feedback rating and recent negative feedback summary. Tracks seller reputation metrics across your account.

Category 12: FBA Optimization & Cost Management (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.

Category 13: Cost Configuration & Accounting — Amazon (9 Tools)

list_amazon_cogs — Get a paginated list of ALL configured COGS (Cost of Goods Sold) records for your account.

create_amazon_cogs — Create a NEW COGS configuration entry: set unit cost for a product/SKU.

edit_amazon_cogs — Update an EXISTING COGS entry: change unit cost, effective date, or other COGS parameters.

delete_amazon_cogs — DELETE one or more COGS records by cogs_id (batch delete supported, max 100).

list_amazon_indirect_cost_settings — Get a paginated list of ALL INDIRECT COST SETTINGS (configuration rules) that you've set up.

create_amazon_indirect_cost — Create a NEW indirect cost setting (configuration rule) for automated cost tracking.

edit_amazon_indirect_cost — Update an EXISTING indirect cost setting: change cost formula, effective date, or calculation parameters.

delete_amazon_indirect_costs — DELETE one or more indirect cost settings by cost_id (batch delete supported, max 100).

list_amazon_indirect_costs — Get a paginated list of EXPANDED/MATERIALIZED indirect costs (actual charges calculated from settings).

Category 13b: Cost Configuration & Accounting — Walmart (8 Tools)

list_wmt_cogs — Get a paginated list of ALL configured COGS (Cost of Goods Sold) records for your Walmart account.

edit_wmt_cogs — Update an EXISTING Walmart COGS entry: change unit cost or effective date.

delete_wmt_cogs — DELETE one or more Walmart COGS records by cogs_id (batch delete supported, max 100).

list_wmt_indirect_cost_settings — Get a paginated list of ALL INDIRECT COST SETTINGS for Walmart.

list_wmt_indirect_costs — Get a paginated list of EXPANDED/MATERIALIZED Walmart indirect costs (actual charges calculated from settings).

create_wmt_indirect_cost — Create a NEW Walmart indirect cost setting (configuration rule).

edit_wmt_indirect_cost — Update an EXISTING Walmart indirect cost setting.

delete_wmt_indirect_costs — DELETE one or more Walmart indirect cost settings by cost_id (batch delete supported, max 100).

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

atlassianUserInfo — Get current user info and account permissions: email, account ID, plan level, features available, and role.

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.

get_my_amazon_seller_accounts — Get list of all authenticated Amazon seller accounts linked to your Helium 10 account.

Category 15: 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.

check_asin_keyword_index — Check whether an ASIN is INDEXED for specific keywords on Amazon. Returns indexed/not-indexed status per keyword.

Category 16: Keyword Trend Analysis (1 Tool)

get_google_trends_history — Get Google Trends search interest history for a keyword over time. Track Google search interest trends, identify seasonal keyword demand, and validate market viability of keywords.

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. Returns sales metrics, affiliate share, creator counts.

search_tiktok_influencers — Search TikTok creators by keyword, category, follower count, engagement rates (video and live), GMV band, units-sold band. Returns follower data and performance metrics.

get_tiktok_product_influencers — Given a product ID, get all creators promoting or selling that specific product with their GMV, units sold, and video count for that product.

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, creator who posted it, and engagement metrics.

Category 18: Keyword Tracker Management (6 Tools)

list_tracked_products — Get a paginated list of ALL products you're tracking in Keyword Tracker with their current metrics and tracking status.

add_untracked_product_keywords — ADD new keywords to your Keyword Tracker for a specific product (ASIN). Batch-add multiple keywords at once.

delete_tracked_keywords — REMOVE specific keywords from your Keyword Tracker for a product. Batch-delete supported (up to 100 at once).

delete_tracked_product — REMOVE an entire product from your Keyword Tracker. This stops all rank tracking for that ASIN.

link_keyword_tag — Attach tags to tracked keywords for organization and categorization. Batch operations supported.

unlink_keyword_tag — Remove tags from tracked keywords. Batch operations supported.

add_keyword_note — Add notes to tracked keywords for tracking observations, strategy notes, or follow-up items.

update_keyword_note — Update existing notes on tracked keywords.

remove_keyword_note — Remove notes from tracked keywords.

Category 19: My List — Keywords & Saved Products (4 Tools)

list_keyword_folders — Browse your keyword folders in My List (Keyword Manager). Returns folder structure and organization.

list_folder_keywords — Get all keywords inside a specific folder in Keyword Manager.

add_keywords_to_folder — Add keywords to a folder in Keyword Manager. Batch operations supported.

list_saved_products — Get all products saved in My List (Black Box saved products). Returns your saved product library with current metrics.

Category 20: Amazon Influencer Discovery (6 Tools)

search_amazon_influencers — Search influencers by filters: niche, follower count, engagement metrics, content type. Discover creators relevant to your products.

get_amazon_influencer_profile — Get detailed profile for one influencer: followers, engagement rates, content categories, past promotions, contact info.

search_amazon_influencer_videos — Get videos for a specific influencer: video topics, engagement metrics, product mentions, audience demographics.

list_amazon_influencer_folders — Browse folders in your Amazon Influencer Finder My List.

list_amazon_influencers_in_folder — Get all influencers saved in a specific folder.

add_amazon_influencers_to_folder — Add influencers to folders for organization. Batch operations supported.

Category 21: Market Tracker & Category Research (5 Tools)

list_user_markets — List all Helium 10 Market Tracker 360 (MT360) markets for your authenticated account. Available exclusively to users with MT360 add-on.

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.

get_market_statistics — Get headline Market Performance statistics for one MT360 market: your share, market share by category, competitive metrics, performance indicators.

get_market_leaderboard — Get ranked leaderboard for one MT360 market: top categories, brands, or sellers by specified metrics.

get_market_products — Get paginated current product rows for one MT360 market: ASIN attributes, BSR, pricing, reviews, sales data.

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, tag keywords, add/update/remove notes)
• Execute campaign actions (pause, resume, create, adjust Amazon ad campaigns)
• Build automation rules by conversation (Ads Rules MCP)
• Query change history for all campaign actions (Ads Changelog MCP)

❌ 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

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

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 Google Trends (get_google_trends_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. Tag keywords for organization (link_keyword_tag)
5. Review updated tracking list (list_tracked_keywords)
6. Remove underperforming keywords (delete_tracked_keywords)

Workflow 5: Analyze Walmart Profitability

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. Analyze cost structure (list_wmt_indirect_cost_settings)
5. Monitor inventory levels (get_wmt_inventory_values)
6. 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

Workflow 7: Build Automated Campaign Rules

1. Query current campaign performance (execute_ads_query)
2. Identify underperforming campaigns (ACoS above target)
3. Build automation rule (manage_ads_rule) — "Pause any campaign with ACoS over 50% on weekdays"
4. Review draft rule and approve
5. Monitor rule execution with Change Log (execute_ads_changelog_query)

Workflow 8: Monitor Account Health & Real-Time Changes

1. Check overall account health (get_seller_account_health)
2. Review recent changes (get_change_rollup)
3. Check for B2B offer changes (search_b2b_offer_change_notifications)
4. Review fee/promotion notifications (search_fee_promotion_notifications)
5. Monitor Buy Box status (get_buybox_summary)

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 applies. 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. Ads Rules MCP lets you build automation rules.

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.

Can I search the Amazon keyword database?
Yes. Use search_amazon_keywords to access Helium 10's extensive keyword database.

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.

Can I tag and organize my tracked keywords?
Yes. Use link_keyword_tag and unlink_keyword_tag to organize tracked keywords by tags. Use add_keyword_note, update_keyword_note, and remove_keyword_note to manage notes on keywords.

Can I build automation rules for my campaigns?
Yes. Ads Rules MCP lets you build, edit, and manage Amazon Bid Rules automation in plain English. Rules are draft-first and approval-gated — nothing goes live until you explicitly confirm.

Can I see the change history of my campaigns?
Yes. Ads Changelog MCP lets you query all bid, budget, keyword, negative, campaign status, and placement changes with old value, new value, who made it, and when. Filterable by actor: rules, schedules, AI bidding, MCP/agent, manual H10 edits, or external Seller Central changes.

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"?
This error 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.

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
• Manage MCP Connections: Helium 10 → Settings → MCP → Authorized AI Clients Management