Getting Started with Helium 10 MCP

Table of Contents

1. Introduction
2. What is MCP?
3. Real-World Examples
4. Who Should Use MCP?
5. How Does MCP Work?
6. How to Configure & Connect MCP
7. What MCP Can & Cannot Do
8. API Rate Limits & Optimization
9. Best Practices
10. Sub-User Access to Primary Accounts via MCP
11. Complete Tool Reference (169 Tools)
12. Frequently Asked Questions
13. 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 Cursor, enabling intelligent analysis of your seller data in real-time. This guide will walk you through setup, capabilities, and best practices.

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.

The Problem MCP Solves

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

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

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?"
• "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?"

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

Who Should Use MCP?

How Does MCP Work?

The Architecture

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

1. You ask a question — Type your request in Claude, ChatGPT, or Cursor
2. AI reads your query — The AI assistant 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 returned — Helium 10's servers send the requested data securely
5. Analysis & response — The AI interprets the data and provides insights in plain language

Available Data Access

Helium 10 MCP provides 169 tools across 28 functional categories:

How to Configure & Connect MCP

Before You Start

• Helium 10 Diamond plan or higher
• A supported AI tool (Claude, ChatGPT, or Cursor)
• Note: Any other software outside of the above is not supported

Setup Steps

1. Open your AI tool settings:
   • Claude Web → Customize → Connectors
   • Claude Desktop → Customize → Connected Applications
   • ChatGPT → Settings → Connectors
   • Cursor → Settings → Features → MCP
2. Find Helium 10 MCP — Search for "Helium 10 MCP" in available connectors
3. Click Connect or Add — Select the connector and initiate the connection process
4. Authorize in browser — Enter your Helium 10 credentials
5. Choose account and approve — Select the appropriate account and click "Continue" to approve the MCP connection

Managing Your Connections

Once connected, you can view and manage your active MCP sessions:

• Go to Helium 10 → Settings → MCP → Authorized AI Clients Management
• Revoke any connection you no longer use

Setting Expectations: What MCP Can & Cannot Do

What MCP CAN Do

✓ Real-Time Data Access — Pull live data from your Helium 10 account instantly

✓ Works with Popular AI Tools — Compatible with Claude, ChatGPT, and Cursor

✓ Secure Data Handling — OAuth 2.0 authentication, end-to-end encrypted connections, no credential sharing

✓ Read & Write Capabilities — Access data and manage keyword tracking, My List organization, influencer folders, campaign actions, and automation rules

✓ Multi-Account Support — Sub-users can access primary accounts via MCP if granted permission

✓ Multiple Marketplaces — Amazon (US, UK, DE, JP, CA, AU, FR, ES, IT, NL, PL, SE, MX), Walmart US, TikTok Shop US

What MCP CANNOT Do

✗ Access Seller Central directly — MCP accesses Helium 10 data only

✗ Create FBA shipments or manage inbound shipments — These require Seller Central

✗ Process refunds or handle A-to-Z Guarantee claims

✗ Send direct messages to customers

✗ Modify listing images, video, or A+ content — This requires manual updating in Seller Central

✗ Adjust subscription plans or manage billing

✗ Delete seller accounts or business registrations

✗ Create or manage brand registry or trademark claims

✗ Access tax or VAT settings

✗ Modify account security settings — Two-factor authentication, IP whitelisting, etc.

Important Data Limitations

API Rate Limits & Optimization

Monthly Allowance

• Included with Diamond+ plan: 1,000 API calls/month
• Top-up option: $50 for 500 additional API calls/month
• Shared quota: Your 1,000 monthly calls are shared between your main account and all sub-accounts
• MCP usage is tracked separately and does not count against the usage limits of tools on the website

Simple API Call Budgeting

• Simple queries: 1–2 API calls
• Comprehensive reports: 5–10 calls
• Avoid redundant lookups — reference earlier results instead of re-querying
• Batch add/remove keywords to reduce API calls
• Test campaign actions on small sets before scaling

Best Practices

Query & Data Best Practices

Be specific in your prompts:

• Bad: "Find keywords"
• Good: "Find keywords that ASIN B0XXXXXXXX is ranking for in the US marketplace"

When referencing Amazon products:

• Always use 10-character ASIN (e.g., B0XXXXXXXX)
• Do not use SKU, UPC, EAN, or GTIN — these won't work

Specify the marketplace explicitly:

• Default is US marketplace. Say "UK marketplace" or "Amazon Germany" if needed

For Walmart queries:

• Use get_my_wmt_seller_accounts first if you're unsure which seller account to query

For TikTok queries:

• Use natural language categories — "beauty," "fashion," etc. (system auto-maps to taxonomy)
• Filter by time window (7/14/30 days) and performance band to narrow results

Combine tools in one request:

• Ask Claude to pull multiple tools and synthesize insights

For batch operations:

• Keyword batch analysis supports up to 200 keywords per request
• Split larger lists into multiple requests

Performance Best Practices

• Keep queries specific to reduce response time
• Limit data scope — only request fields and timeframes you need
• Space out large queries to avoid hitting monthly rate limits
• Simple queries typically take 2–5 seconds; complex reports take 5–15 seconds
• Use list_my_products first when you don't have an ASIN
• For Walmart, start with account-level summary before drilling into products

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 Cursor)
2. Search for and select Helium 10 MCP
3. Click Connect and complete the OAuth authorization
4. The MCP will grant access to the primary account and any approved sub-accounts

Complete Tool Reference (169 Tools)

Total Tools Available: 169 | Functional Categories: 28 | API Calls Per Month: 1,000 (included) | Supported Marketplaces: Amazon (US, UK, DE, JP, CA, AU, FR, ES, IT, NL, PL, SE, MX), Walmart US, TikTok Shop US

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.

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.

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.

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. Supports Amazon and Walmart US.

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

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. Supports Amazon and Walmart US.

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

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.

Note: Account-level Sessions in Profits now use Amazon's store-level figure (not SKU sum), effective October 13, 2026.

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 5C: PROFIT & LOSS ANALYTICS — TIKTOK SHOP (8 Tools)

get_tt_account_profit_and_loss_summary — Get a SUMMARY of your entire TikTok Shop account's P&L for a specific time period: revenue, COGS, advertising spend, and net profit. US marketplace only.

get_tt_account_profit_and_loss_summary_series — Get TikTok Shop account P&L TREND DATA over time.

get_tt_account_profit_and_loss_breakdown — Get DETAILED P&L breakdown for entire TikTok Shop account by product category, cost component, or other dimensions.

get_tt_account_profit_and_loss_breakdown_series — Get TikTok Shop P&L BREAKDOWN TRENDS over time.

get_tt_product_profit_and_loss_summary — Get P&L SUMMARY for a SPECIFIC TikTok Shop PRODUCT over a time period.

get_tt_product_profit_and_loss_summary_series — Get P&L TREND DATA for a specific TikTok Shop product over time.

get_tt_product_profit_and_loss_breakdown — Get DETAILED P&L breakdown for a specific TikTok Shop product.

get_tt_product_profit_and_loss_breakdown_series — Get P&L breakdown TRENDS for a TikTok Shop product over time.

Note: TikTok Shop P&L uses TACoS (Total Advertising Cost of Sales), not ACoS. Data status is provided per response (Actual/Partially Estimated/Estimated). TikTok finance data can lag 7 days to 2 months behind real-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.

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.

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 6C: INVENTORY MANAGEMENT — TIKTOK SHOP (3 Tools)

get_my_tt_seller_accounts — Discover which TikTok Shop seller accounts are currently connected to your Helium 10 account.

get_tt_inventory_values — Get CURRENT TikTok Shop inventory quantity metrics: units in stock by fulfillment type (FBS - Fulfillment by Seller and FBT - Fulfillment by TikTok).

get_tt_sales_velocity — Get units SOLD over time for TikTok Shop products, bucketed by day, week, or month.

CATEGORY 7: TRAFFIC ANALYTICS (2 Tools)

get_amazon_seller_traffic — Get STORE-LEVEL traffic data as a daily series: sessions, page views, and conversion rate for your entire Amazon store across all products and marketplaces.

get_amazon_product_traffic — Get PRODUCT-LEVEL traffic as a daily series: sessions, page views, and conversion rate for individual SKUs across all marketplaces.

CATEGORY 8: 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 9: 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. Supports Bid Rules, Budget Rules, Placement Rules, Keyword Harvesting Rules, and Negative Targeting Rules.

manage_ads_rule — STEP 3 (TERMINAL) of Ads Rules: Build, edit, and manage Amazon automation rules in plain English. Supports all 5 rule types. Draft-first and approval-gated.

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.

CATEGORY 10: 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.

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

CATEGORY 12: 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 13: 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 14: 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 14B: COST CONFIGURATION & ACCOUNTING — WALMART (8 Tools)

list_wmt_cogs — Get a paginated list of ALL configured COGS 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 14C: COST CONFIGURATION & ACCOUNTING — TIKTOK SHOP (8 Tools)

list_tt_cogs — Get a paginated list of ALL configured COGS records for your TikTok Shop account.

edit_tt_cogs — Update an EXISTING TikTok Shop COGS entry: change unit cost or effective date.

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

list_tt_indirect_cost_settings — Get a paginated list of ALL INDIRECT COST SETTINGS for TikTok Shop.

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

create_tt_indirect_cost — Create a NEW TikTok Shop indirect cost setting (configuration rule).

edit_tt_indirect_cost — Update an EXISTING TikTok Shop indirect cost setting.

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

CATEGORY 15: 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 16: 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 17: 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.

CATEGORY 18: 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. 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.

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.

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, and engagement metrics.

CATEGORY 19: KEYWORD TRACKER MANAGEMENT (11 Tools)

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

add_untracked_product_keywords — ADD new keywords to your Keyword Tracker for a specific product (ASIN). Batch-add multiple keywords. Supports Amazon and Walmart US.

delete_tracked_keywords — REMOVE specific keywords from your Keyword Tracker for a product. Batch-delete supported (up to 100). Supports Amazon and Walmart US.

delete_tracked_product — REMOVE an entire product from your Keyword Tracker. Supports Amazon and Walmart US.

add_keyword_competitors — ADD competitor ASINs to track for a specific keyword. Monitor how competitors rank for keywords you're tracking. Amazon only.

remove_keyword_competitors — REMOVE competitor ASINs from keyword tracking. Amazon only.

link_keyword_tag — Attach tags to tracked keywords for organization. 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 and strategy notes.

update_keyword_note — Update existing notes on tracked keywords.

remove_keyword_note — Remove notes from tracked keywords.

CATEGORY 20: MY LIST — KEYWORDS & SAVED PRODUCTS (11 Tools)

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

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

create_keyword_folder — CREATE a new folder in Keyword Manager. Organize keywords by campaign, category, or strategy.

rename_keyword_folder — RENAME an existing folder in Keyword Manager.

delete_keyword_folder — DELETE a keyword folder. Warning: Removes all keywords in that folder.

add_keywords_to_folder — Add keywords to a folder. Batch operations supported.

delete_keywords_from_folder — REMOVE keywords from a folder. Batch operations supported.

move_keywords_between_folders — MOVE keywords from one folder to another. Reorganize your keyword library.

list_saved_products — Get all products saved in My List (Black Box saved products).

add_saved_product — ADD a product to My List. Save products for later research or comparison.

delete_saved_product — REMOVE a product from My List.

CATEGORY 21: AMAZON INFLUENCER DISCOVERY & MANAGEMENT (10 Tools)

search_amazon_influencers — Search influencers by filters: niche, follower count, engagement metrics, content type.

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.

remove_amazon_influencers_from_folder — REMOVE influencers from folders. Update your influencer organization.

create_amazon_influencer_folder — CREATE a new folder in Amazon Influencer Finder My List.

rename_amazon_influencer_folder — RENAME an existing influencer folder.

delete_amazon_influencer_folders — DELETE an influencer folder. Warning: Removes all influencers in that folder.

CATEGORY 22: FOLLOW-UP EMAIL AUTOMATION (6 Tools)

get_followup_account_status — Get your account's current Follow-Up configuration: sending allowance, daily send limits, current send status, and enabled automations.

list_followup_automations — Get a paginated list of ALL Follow-Up automations in your account: name, type, status, and performance summary.

get_followup_automation — Get FULL CONFIGURATION of ONE Follow-Up automation: trigger conditions, email body, recipient filters, send timing, and historical performance.

get_followup_automation_performance — Get TIME-SERIES performance data for ONE automation: daily/weekly send counts, delivery rate, open rate, click rate, reply rate.

get_followup_email_stats — Get TIME-SERIES statistics for CUSTOM EMAIL automations: daily send counts, delivery metrics, engagement rates over a date range.

get_followup_review_request_stats — Get TIME-SERIES statistics for AMAZON REQUEST-A-REVIEW automations: daily request counts, review generation rate, review rating distribution.

Note: Follow-Up MCP provides email bodies and performance totals only; individual open/click/reply events are not accessible.

CATEGORY 23: 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.

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

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

Frequently Asked Questions

Is MCP included in my plan?

Yes! MCP is a free feature for all Diamond and above plan members. You have 1,000 API calls/month included. MCP usage is tracked separately and does not count against the usage limits of tools on the website.

Which AI tools support MCP?

Any MCP-compatible client works with Helium 10. Currently supported: Claude (Web & Desktop), ChatGPT, and Cursor.

Do I have to pay extra for MCP?

No. MCP is included in your plan with no additional fees. Top-up packs are available for additional API calls beyond your monthly allowance.

What's the MCP Top-up option?

$50 for 500 additional API calls per month. Purchase via Helium 10 subscription management page. If you have a yearly or Enterprise subscription, contact support to add this to your account.

How many API calls does one question use?

It varies: Simple query (1–2 calls), report with analysis (2–5 calls), complex multi-step research (5–15 calls). A typical conversation with 5–10 questions uses 15–50 API calls total.

Why does my data look different between MCP and the Helium 10 dashboard?

Possible causes: Data freshness (pipeline updated at different times), metric definitions (parent vs. child ASIN level), currency units (some values in cents), or filters applied differently. Check filters and timestamps first. If data consistently looks wrong, contact Helium 10 support.

Why is my ASIN showing no data?

Common reasons: ASIN doesn't exist in Helium 10 for that marketplace, ASIN not added to Keyword Tracker yet (for tracker tools), product inactive for 360+ days, incorrect ASIN format (must be exactly 10 characters), or insufficient permissions for data type.

What does "permission denied" mean?

Some features require specific plans or program enrollment: Brand Analytics requires Diamond AND Brand Registry, certain data requires specific plan tiers. If you believe you should have access, try reconnecting MCP or contact support.

Why is Keyword Tracker showing "null" or "none" for rank values?

"Null" or "None" means the ASIN isn't currently ranked in that surface (organic or sponsored). This is normal — for example, products without active Sponsored Ads campaigns will show null sponsored rank.

Can MCP make changes to my listings or campaigns?

Selectively. MCP can: Manage keyword tracker (add/remove keywords, add competitors, organize with tags and notes), organize My List (create folders, add/save products), manage Amazon Influencer folders, pause/resume/adjust campaigns, and build automation rules for ads. MCP cannot: modify listing content, create FBA shipments, process refunds, or change account settings.

Is my data safe? Does the AI store it?

Helium 10 uses OAuth 2.0 (same standard as banking apps), so the AI never receives your credentials. Regarding storage: the AI processes your data to generate responses. How that data is handled is governed by the AI provider's privacy policy (e.g., Anthropic's Privacy Policy for Claude).

Why did the AI use different numbers for the same question asked twice?

The AI likely called the tool again and retrieved slightly updated data if the Helium 10 pipeline refreshed between requests. This is expected. Reference earlier data explicitly if you need consistent numbers for comparison.

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 and revoke the connection. Then reconnect via your AI tool settings.

Can I track keywords on Walmart?

Yes. Keyword Tracker now supports Walmart US marketplace. You can add keywords, track rank history, and organize with tags.

Can I see all my linked seller accounts?

Yes. Use appropriate tools to discover: get_my_amazon_seller_accounts (Amazon), get_my_wmt_seller_accounts (Walmart), get_my_tt_seller_accounts (TikTok Shop).

Can I analyze TikTok Shop profitability?

Yes. Use TikTok Shop P&L tools to track account-level and product-level profitability. Note that TikTok uses TACoS (Total Advertising Cost of Sales), not ACoS, and data can lag 7 days to 2 months.

Can I build automation rules for my campaigns?

Yes. Ads Rules MCP lets you build Amazon automation rules in plain English. Supported rule types include Bid Rules, Budget Rules, Placement Rules, Keyword Harvesting Rules, and Negative Targeting Rules. 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, and campaign status changes with old value, new value, who made it, and when.

What does "GMV" mean in TikTok tools?

GMV = Gross Merchandise Value — total revenue generated by influencers, products, or videos on TikTok Shop during the selected time window.

What does "TACoS" mean in TikTok Shop P&L?

TACoS = Total Advertising Cost of Sales — the percentage of total TikTok Shop revenue spent on advertising. Different from Amazon's ACoS (Advertising Cost of Sale), which only includes sponsored ads.

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. To resolve: Go to your Helium 10 Ads Settings, locate your Ads profile, change it from "Disable" or "Analytics-only" to "Managed", save, and retry your Ads action. Important: Profiles in "Managed" mode incur a 2% fee on all advertising spend.

Getting Help

Helium 10 Support: kb.helium10.com or Contact Support

Manage MCP Connections: Helium 10 → Settings → MCP → Authorized AI Clients Management