Skip to main content
Glama

amazon-product-research-mcp

Server Details

Amazon brand, seller, niche & buy-box intelligence inside your own Claude or ChatGPT.

Status
Healthy
Last Tested
Transport
Streamable HTTP
URL
Repository
ncosic/webotee-mcp
GitHub Stars
0
Server Listing
Webotee Amazon Product Research

Glama MCP Gateway

Connect through Glama MCP Gateway for full control over tool access and complete visibility into every call.

MCP client
Glama
MCP server

Full call logging

Every tool call is logged with complete inputs and outputs, so you can debug issues and audit what your agents are doing.

Tool access control

Enable or disable individual tools per connector, so you decide what your agents can and cannot do.

Managed credentials

Glama handles OAuth flows, token storage, and automatic rotation, so credentials never expire on your clients.

Usage analytics

See which tools your agents call, how often, and when, so you can understand usage patterns and catch anomalies.

100% free. Your data is private.
Tool DescriptionsA

Average 4.1/5 across 76 of 76 tools scored. Lowest: 3.1/5.

Server CoherenceA
Disambiguation5/5

Each tool has a highly specific and clearly documented purpose, with detailed descriptions that differentiate even similar functions. For example, find_undercompeted_brands returns brands while find_underserved_niches returns sub-categories, and the descriptions explicitly warn against confusion. Overlap is minimal and well-addressed.

Naming Consistency5/5

Tool names consistently follow a snake_case verb_noun pattern, with domain prefixes (asin_, brand_, category_, operator_, watchlist_) making intent obvious. Even compound names like find_undercompeted_brands and top_expanding_operators are logically structured. The variation is intentional and supports readability.

Tool Count2/5

With 76 tools, the count far exceeds the rubric's 'too many' threshold of 25+. While each tool serves a distinct purpose in a comprehensive platform, the volume risks overwhelming both users and agents, leading to selection difficulty even with good disambiguation.

Completeness5/5

The tool surface covers the full lifecycle of Amazon product research: discovery (search, category analysis), evaluation (sourcing, profit calc), monitoring (watchlists, alerts), protection (authorized sellers, MAP violations), and cross-marketplace analysis. Virtually no obvious gaps exist for the stated domain.

Available Tools

76 tools
asin_buybox_history
Read-only
Inspect

Show which sellers have been winning the buybox for an ASIN over time, AND how the competing-seller pool has changed month over month. Returns a per-week breakdown of buybox winners; a monthly distinct-seller-count series (seller_count_monthly, trailing ~6 months) plus a seller_trend label (stable/rising/falling) so you can say whether the seller pool is stable or volatile (more sellers piling on vs consolidating); plus the ASIN's product brand, title and price (or price range) and its fulfillment (FBA/FBM/AMZ). Use when the user asks 'who has been winning buybox on this ASIN', 'buybox history for B08N5WRWNW', 'seller rotation', 'has the buybox owner changed', 'is the seller pool stable or volatile', 'are more sellers piling onto this listing', or any ASIN buybox/seller timeline.

ParametersJSON Schema
NameRequiredDescriptionDefault
asinYesASIN to look up (e.g. B08N5WRWNW).
max_priceNo
min_priceNo
seller_nameNoExact buy-box seller name (case-insensitive).
since_weeksNoWeeks of history (default 26, max 52).
last_seen_toNo
first_seen_toNo
max_days_seenNo
min_days_seenNo
product_brandNoExact product brand (case-insensitive).
fulfillment_inNoComma-separated FBA/FBM/AMZ to keep.
last_seen_fromNo
marketplace_idNo1 = Amazon UK, 2 = Amazon US (default)
first_seen_fromNoYYYY-MM-DD.
max_seller_countNo
min_seller_countNo
max_buybox_avg_priceNo
min_buybox_avg_priceNo
seller_name_containsNo
product_brand_containsNo
product_title_containsNo
max_observed_buybox_daysNo
min_observed_buybox_daysNoOnly sellers with at least this many observed buy-box days.
max_fulfillment_amz_dom_pctNo
max_fulfillment_fba_pen_pctNo
min_fulfillment_amz_dom_pctNo
min_fulfillment_fba_pen_pctNo
asin_comparables
Read-only
Inspect

Find ASINs similar to a given ASIN by brand, price band, and seller count. Use when the user asks 'ASINs like this one', 'similar products', 'comparable ASINs', 'what else is like B08N5WRWNW', or any ASIN-level lookalike question. Each comparable carries product brand, title, price (or price range) and fulfillment (FBA/FBM/AMZ + amz/fba pct).

ParametersJSON Schema
NameRequiredDescriptionDefault
asinYesReference ASIN (e.g. B08N5WRWNW).
limitNo
max_priceNo
min_priceNo
buybox_sellerNoExact buy-box seller name (case-insensitive).
product_brandNoExact product brand (case-insensitive).
fulfillment_inNoComma-separated FBA/FBM/AMZ to keep.
marketplace_idNo1 = Amazon UK, 2 = Amazon US (default)
max_seller_countNo
min_seller_countNoOnly comparables with at least this many distinct sellers.
max_days_observedNo
min_days_observedNo
buybox_seller_containsNo
product_brand_containsNo
product_title_containsNo
max_fulfillment_amz_dom_pctNo
max_fulfillment_fba_pen_pctNo
min_fulfillment_amz_dom_pctNo
min_fulfillment_fba_pen_pctNo
asin_profit_calc
Read-only
Inspect

Estimate whether an ASIN can hit a target profit margin given current buybox price, estimated FBA fees, and Amazon referral fee. Use when the user asks 'can I make money on this ASIN', 'profit calculator', 'margin estimate for B08N5WRWNW', 'is this ASIN profitable to sell', or any margin/profit question. Also returns product brand, title, price (or price range) and fulfillment (FBA/FBM/AMZ + amz/fba pct) for the ASIN.

ParametersJSON Schema
NameRequiredDescriptionDefault
asinYesASIN to analyze (e.g. B08N5WRWNW).
cogsNoYour cost of goods in USD. If omitted, the tool estimates breakeven COGS.
marketplace_idNo1 = Amazon UK, 2 = Amazon US (default)
target_margin_pctNoTarget profit margin percentage (default 20).
authorized_seller_list
Read-only
Inspect

List the saved authorized sellers for a brand. Use when the user asks 'who are my authorized sellers for X', 'show my approved resellers', 'what's my whitelist for this brand'.

ParametersJSON Schema
NameRequiredDescriptionDefault
brandYesThe brand.
marketplace_idNo1 = Amazon UK, 2 = Amazon US (default)
seller_containsNoOnly return saved seller names containing this substring (case-insensitive).
authorized_seller_setInspect

Save the authorized sellers for a brand you own/manage — the whitelist that makes 'unauthorized seller' detection possible. The brand must already be tracked in this workspace. Use when the user says 'these are my authorized sellers for X', 'add Y to my authorized list', 'set my brand's approved resellers'. Pass the seller names exactly as they appear on Amazon.

ParametersJSON Schema
NameRequiredDescriptionDefault
brandYesThe brand (must be a tracked workspace brand).
sellersYesAuthorized seller names to save.
marketplace_idNo1 = Amazon UK, 2 = Amazon US (default)
brand_buybox_trajectory
Read-only
Inspect

Show how a brand's buybox concentration has changed over time. Returns weekly seller counts and observed buybox days for the trailing window. Use when the user asks 'is this brand getting more competitive', 'concentration trend for Nike', 'how has seller count changed over time', or 'buybox trajectory'.

ParametersJSON Schema
NameRequiredDescriptionDefault
brandYesBrand name (case-insensitive).
trend_inNoComma-separated trend labels to keep: CONCENTRATING, DECONCENTRATING, STABLE, INSUFFICIENT_DATA. If the brand's trend isn't in the list, an empty result is returned.
since_weeksNoWeeks of history to return (default 26, max 52).
week_start_toNo
marketplace_idNo1 = Amazon UK, 2 = Amazon US (default)
week_start_fromNoKeep only timeline weeks on/after this YYYY-MM-DD.
max_observationsNo
max_seller_countNo
min_observationsNo
min_seller_countNoKeep only timeline weeks with at least this seller_count.
max_asins_touchedNo
min_asins_touchedNo
max_observed_buybox_daysNo
min_observed_buybox_daysNo
max_seller_count_change_pctNo
min_seller_count_change_pctNo
brand_new_asins
Read-only
Inspect

Show ASINs that recently appeared for a brand. Use when the user asks 'new products for Nike', 'recently added ASINs', 'what new listings does this brand have', or any question about a brand's recent catalog additions. Each ASIN carries product brand, title, price (or price range) and fulfillment (FBA/FBM/AMZ + amz/fba pct).

ParametersJSON Schema
NameRequiredDescriptionDefault
asinNoExact ASIN match.
brandYesBrand name (case-insensitive).
limitNo
max_priceNo
min_priceNo
since_daysNoHow far back to look (default 30, max 180).
last_seen_toNo
asin_containsNo
first_seen_toNo
product_brandNoExact product brand (case-insensitive).
fulfillment_inNoComma-separated FBA/FBM/AMZ to keep.
last_seen_fromNo
marketplace_idNo1 = Amazon UK, 2 = Amazon US (default)
first_seen_fromNoYYYY-MM-DD (since_days already bounds the lower edge).
max_latest_priceNo
max_seller_countNo
min_latest_priceNo
min_seller_countNo
latest_buybox_sellerNoExact most-recent buy-box seller (case-insensitive).
product_brand_containsNo
product_title_containsNo
max_fulfillment_amz_dom_pctNo
max_fulfillment_fba_pen_pctNo
min_fulfillment_amz_dom_pctNo
min_fulfillment_fba_pen_pctNo
latest_buybox_seller_containsNo
brands_gaining_sellers
Read-only
Inspect

Find brands that recently gained the most newly-OBSERVED sellers (sellers whose first-seen date on the brand falls in the window) — an observation signal, NOT confirmed market entry (sparse re-sampling can resurface long-present sellers as 'new'). Optional category filter. Use when the user asks 'brands gaining sellers in [category]', 'brands under hijacker pressure', 'who is seeing new entrants this month', or category-scoped seller-growth signals without naming a specific brand.

ParametersJSON Schema
NameRequiredDescriptionDefault
brandNoExact brand match (case-insensitive).
limitNo
scopeNotracked = only brands on the user's watchlist; universe = all brands. Default universe.
categoryNo
window_daysNoDays back (default 30, max 90).
brand_containsNo
marketplace_idNo1 = Amazon UK, 2 = Amazon US (default)
min_new_sellersNoMinimum new-seller count to surface (default 2).
max_control_scoreNo
min_control_scoreNo
max_total_sellers_3mNo
min_total_sellers_3mNo
max_seller_churn_30d_pctNo
min_seller_churn_30d_pctNo
max_catalog_churn_30d_pctNo
min_catalog_churn_30d_pctNo
max_newly_observed_sellers_in_windowNoUpper bound on new-seller count (min is min_new_sellers).
brand_similar
Read-only
Inspect

Find brands similar to a given brand by category, price tier, and competition level. Use when the user asks 'brands like Nike', 'similar brands to source', 'show me comparable brands', 'what else is in this niche', or any cohort/lookalike question.

ParametersJSON Schema
NameRequiredDescriptionDefault
brandYesReference brand name (case-insensitive).
limitNo
max_avg_priceNo
min_avg_priceNo
brand_containsNoOnly keep similar brands whose name contains this substring.
marketplace_idNo1 = Amazon UK, 2 = Amazon US (default)
max_asin_countNo
min_asin_countNo
max_seller_countNo
min_seller_countNoOnly similar brands with at least this many unique sellers (3m).
max_control_scoreNo
min_control_scoreNo
max_buybox_days_3mNo
min_buybox_days_3mNo
brands_in_operator_network
Read-only
Inspect

Find brands that share operators/sellers with a target brand. Returns brands ranked by how many operators they share. Use when the user asks 'what brands are in X's network?', 'brands related to Ninja', 'who else do Ninja's sellers carry?', 'brands in the same seller network', or 'brand family'. This reveals the operator graph — brands connected through shared distribution channels.

ParametersJSON Schema
NameRequiredDescriptionDefault
brandYesThe target brand to find network connections for.
limitNo
brand_containsNoOnly keep related brands whose name contains this substring.
marketplace_idNo1 = Amazon UK, 2 = Amazon US (default)
max_seller_countNo
min_seller_countNo
max_control_scoreNo
min_control_scoreNo
max_shared_operatorsNo
min_shared_operatorsNoOnly related brands sharing at least this many operators.
max_observed_buybox_daysNo
min_observed_buybox_daysNo
brand_under_attack
Read-only
Inspect

Detect whether a brand is under competitive attack: an elevated NEW-ENTRANT RATE (brand-level newly-observed sellers vs the trailing-month baseline) combined with buy-box churn. Uses brand-level first-seen (a seller's first observation anywhere across the brand's ASINs), which is stable under scraper-coverage growth — not the inflated per-ASIN count. Use when the user asks 'is my brand being targeted', 'brand under attack', 'new sellers flooding my listings', 'is someone targeting this brand'.

ParametersJSON Schema
NameRequiredDescriptionDefault
brandYesBrand name (case-insensitive).
signals_inNoComma-separated signals that must be present: NEW_ENTRANT_SURGE, HIGH_BUYBOX_CHURN. Matches if the brand has any of them.
since_weeksNoWindow to analyze (default 4, max 12).
marketplace_idNo1 = Amazon UK, 2 = Amazon US (default)
threat_level_inNoComma-separated threat levels to keep: HIGH, MODERATE, LOW. If the brand's level isn't in the list, an empty result is returned.
brand_xmarket
Read-only
Inspect

Check whether a brand sells on Amazon US, Amazon UK, and/or Walmart. Returns per-marketplace seller count, ASIN count, observed buybox days, and control score. Use when the user asks 'does this brand sell on Walmart', 'cross-marketplace presence for Nike', 'is this brand on Amazon UK', or any multi-marketplace brand question.

ParametersJSON Schema
NameRequiredDescriptionDefault
brandYesBrand name (case-insensitive).
max_asin_countNo
min_asin_countNo
max_seller_countNo
min_seller_countNo
marketplace_id_inNoComma-separated marketplace ids to keep: 1=Amazon UK, 2=Amazon US, 3=Walmart US.
max_control_scoreNo
min_control_scoreNo
max_observed_buybox_daysNo
min_observed_buybox_daysNo
buybox_loss_alert
Read-only
Inspect

Find the ASINs where a brand you own has LOST the buy box to a seller outside your authorized list — ranked by estimated revenue at stake — so you can act on the costliest first. Each flagged ASIN carries its product brand, title and price (or price range) plus its fulfillment (FBA/FBM/AMZ). Save your authorized list first (authorized_seller_set) for precise flagging; without it, ASINs where a third-party operator holds the buy box are flagged. Use when the user asks 'where am I losing the buy box on ', 'buy-box loss on my ASINs', 'which of my listings did I lose'.

ParametersJSON Schema
NameRequiredDescriptionDefault
asinNoExact ASIN match.
brandYesThe brand you own/manage.
limitNo
max_priceNo
min_priceNo
asin_containsNo
buybox_holderNoExact current buy-box holder (case-insensitive).
product_brandNoExact product brand (case-insensitive).
fulfillment_inNoComma-separated FBA/FBM/AMZ to keep.
marketplace_idNo1 = Amazon UK, 2 = Amazon US (default)
max_buybox_priceNo
min_buybox_priceNo
max_est_units_30dNo
min_est_units_30dNo
authorized_sellersNoOptional. Your authorized sellers (else the saved list is used).
buybox_holder_containsNo
product_brand_containsNo
product_title_containsNo
max_observed_buybox_daysNo
min_observed_buybox_daysNo
max_fulfillment_amz_dom_pctNo
max_fulfillment_fba_pen_pctNo
min_fulfillment_amz_dom_pctNo
min_fulfillment_fba_pen_pctNo
max_est_revenue_at_stake_30dNo
min_est_revenue_at_stake_30dNo
categories_amazon_retreating
Read-only
Inspect

Find categories where Amazon is retreating — net brand exits exceed entries over 90 days (amazon_expansion_net_90d < 0). Returns categories ordered by retreat magnitude. Use when the user asks 'where is Amazon pulling back?', 'which categories is Amazon leaving?', or 'Amazon retreat opportunities'.

ParametersJSON Schema
NameRequiredDescriptionDefault
limitNoMax results (capped at 10). Default 10.
category_nameNoExact category name (case-insensitive).
marketplace_idNo1 = Amazon UK, 2 = Amazon US (default)
max_asin_countNo
min_asin_countNo
max_brand_countNo
min_brand_countNo
velocity_tier_inNoComma-separated velocity tiers to keep.
max_pct_amazon_plNo
min_pct_amazon_plNo
category_name_containsNo
max_amazon_expansion_net_90dNo
max_amz_retail_dominance_pctNo
min_amazon_expansion_net_90dNo
min_amz_retail_dominance_pctNo
category_metrics
Read-only
Inspect

Return the full metric set for ONE category at any depth — a root OR a sub-category niche like 'Terrariums'. Covers demand (30-day revenue, units, velocity tier), competition (heat, diversity, brand/ASIN/seller counts), Amazon presence (retail dominance, private-label share, FBA penetration, 90-day brand expansion), price, ship-by days, and close-outs. Use for 'show me the metrics/stats for category X', 'how big is the X category', or to pull the numbers behind a niche question.

ParametersJSON Schema
NameRequiredDescriptionDefault
category_idNoExact category id (any depth).
category_nameNoCategory name (any depth, fuzzy).
marketplace_idNo1=UK, 2=US, 3=Walmart. Default 2 (US).
category_new_entrants
Read-only
Inspect

Find brands newly OBSERVED in a category — the first date our daily sampling saw the brand there falls in the window. An observation signal, NOT confirmed first-ever entry (sparse re-sampling can resurface a long-present brand as 'new'). Use when the user asks 'new brands in Electronics', 'what brands just entered this category', 'emerging brands in Toys', 'category new entrants'.

ParametersJSON Schema
NameRequiredDescriptionDefault
brandNoExact brand match (case-insensitive).
limitNo
since_daysNoHow far back to look (default 30, max 180).
category_idNoRoot category ID.
category_nameNoCategory name (fuzzy match if category_id not provided).
max_avg_priceNo
min_avg_priceNo
brand_containsNo
marketplace_idNo1 = Amazon UK, 2 = Amazon US (default)
max_asin_countNo
min_asin_countNo
max_seller_countNo
min_seller_countNo
first_observed_toNo
max_buybox_days_3mNo
min_buybox_days_3mNo
first_observed_fromNoYYYY-MM-DD lower bound on first-observed date.
category_top_growers
Read-only
Inspect

Find brands in a category with the biggest recent growth in seller count and observations. Use when the user asks 'fastest growing brands in Toys', 'top growers in this category', 'which brands are trending up', or any category-scoped growth question.

ParametersJSON Schema
NameRequiredDescriptionDefault
brandNoExact brand match (case-insensitive).
limitNo
category_idNoRoot category ID.
since_monthsNoMonths to compare (default 3, max 6). Compares latest month vs earliest.
category_nameNoCategory name (fuzzy match if category_id not provided).
brand_containsNo
marketplace_idNo1 = Amazon UK, 2 = Amazon US (default)
max_prior_sellersNo
min_prior_sellersNo
max_obs_growth_pctNo
max_recent_sellersNo
min_obs_growth_pctNo
min_recent_sellersNo
max_seller_growth_pctNo
min_seller_growth_pctNo
max_prior_observationsNo
min_prior_observationsNo
max_recent_observationsNo
min_recent_observationsNo
category_undercompeted_brands
Read-only
Inspect

Find specific BRANDS within a category that have proven multi-seller demand but are still under-competed (a min-seller floor drops single-seller / brand-owner-only listings). Returns BRANDS — not niches or sub-categories. Use for 'undercompeted brands in ', 'low competition brands in Toys', 'which brands can I source in '. Do NOT use for 'under-served niches', 'niches in ', or 'find a niche to enter' — those are SUBCATEGORY questions; use find_underserved_niches instead.

ParametersJSON Schema
NameRequiredDescriptionDefault
brandNoExact brand match (case-insensitive).
limitNo
category_idNoRoot category ID to search within.
max_sellersNoMaximum unique sellers (default 20).
min_sellersNoMinimum unique sellers (default 10). Drops single-seller / brand-owner-only 'PL junk' so results show proven multi-seller demand.
category_nameNoCategory name (fuzzy match if category_id not provided).
max_avg_priceNoMaximum average price in USD. Omit for no cap.
min_avg_priceNoMinimum average price in USD. Omit for no floor.
brand_containsNo
marketplace_idNo1 = Amazon UK, 2 = Amazon US (default)
max_asin_countNo
min_asin_countNo
min_buybox_daysNoMinimum observed buybox days in last 3 months (default 30).
max_velocity_90dNo
min_velocity_90dNo
max_control_scoreNo
min_control_scoreNo
collect_asin_nowInspect

Pull a LIVE, on-demand snapshot of a single Amazon ASIN right now — current title, price, live offers and the sellers on the listing today — and return it alongside Webotee's historical brand and seller intelligence, including the ASIN's product brand, title and price (or price range) and its fulfillment (FBA/FBM/AMZ). Use when the user gives a specific ASIN and wants its CURRENT/today's data rather than the pre-collected dataset (e.g. 'check ASIN B0... right now', 'who's on this listing today and at what price'). Amazon US only; one ASIN per call.

ParametersJSON Schema
NameRequiredDescriptionDefault
asinYesThe 10-character Amazon ASIN to collect live (US).
marketplace_idNoMarketplace (2 = Amazon US). US only.
competitive_landscape
Read-only
Inspect

Map the competitive landscape for a brand or category root. Returns top 10 sellers by observed buybox days held, top 10 brands by winner-diversity HHI, plus week-over-week deltas. Use when the user asks 'who's winning this category?' or 'who controls the buybox here?'.

ParametersJSON Schema
NameRequiredDescriptionDefault
brandNo
seller_nameNoExact seller name in the sellers list (case-insensitive).
marketplace_idNo1 = Amazon UK, 2 = Amazon US (default)
max_brand_countNo
min_brand_countNo
category_root_idNo
max_control_scoreNo
min_control_scoreNo
max_winner_diversityNo
min_winner_diversityNo
seller_name_containsNo
max_unique_sellers_3mNo
min_unique_sellers_3mNo
max_seller_churn_30d_pctNo
min_seller_churn_30d_pctNo
max_catalog_churn_30d_pctNo
max_pct_asins_gated_to_3pNo
min_catalog_churn_30d_pctNo
min_pct_asins_gated_to_3pNo
max_bought_past_month_totalNo
min_bought_past_month_totalNo
max_amz_retail_dominance_pctNo
min_amz_retail_dominance_pctNo
max_total_observed_buybox_daysNo
min_total_observed_buybox_daysNo
max_brand_velocity_90d_units_dayNo
min_brand_velocity_90d_units_dayNo
dominant_category_velocity_tier_inNoComma-separated velocity tiers to keep in the brand list.
max_seller_churn_30d_delta_vs_cat_ppNo
min_seller_churn_30d_delta_vs_cat_ppNo
evaluate_asin_sourcing
Read-only
Inspect

Evaluate a single ASIN for FBA sourcing. Returns composite sourcing score (0-100), 5-dimension breakdown (velocity, gating, friction, margin, brand_posture), estimated 30-day demand (units_30d_final + est_revenue_30d) with its source/badge_band/confidence, a data_coverage flag (full vs velocity_only — so a null demand reads as a coverage gap, not zero sales), star rating + review count (with a rating_coverage flag), brand-level FBA/Amazon dominance, and a red-flag list. Also returns the product brand, title, and price (or price range) plus the ASIN's fulfillment (FBA/FBM/AMZ + amz/fba pct). Use when the user asks 'should I buy this?', 'how fast does this sell?', or shares an ASIN and wants a sourcing recommendation.

ParametersJSON Schema
NameRequiredDescriptionDefault
qtyNoOptional purchase quantity for ROI sizing.
asinYesAmazon ASIN, 10-character alphanumeric.
marketplace_idNo1 = Amazon UK, 2 = Amazon US (default)
evaluate_brand
Read-only
Inspect

Evaluate a brand for portfolio inclusion. Returns brand-level control posture, winner diversity (HHI), Amazon retail dominance %, FBA penetration %, catalog churn rate, total bought-past-month volume, estimated 30-day revenue, avg ship-by days, cross-brand operator count, plus the top 10 ASINs by composite sourcing score (each with product brand, title, price or price range, and fulfillment FBA/FBM/AMZ + amz/fba pct). Use when the user names a brand and asks 'is this worth carrying?', 'how does this brand look?', 'what is the churn rate?', or 'how fast does this brand ship?'.

ParametersJSON Schema
NameRequiredDescriptionDefault
asinNoKeep only this ASIN in top_asins.
brandYesBrand name (case-insensitive).
max_priceNo
min_priceNo
max_gatingNo
max_marginNo
max_ratingNo
min_gatingNo
min_marginNo
min_ratingNo
max_velocityNo
min_velocityNo
asin_containsNo
product_brandNoExact product brand (case-insensitive) on top_asins.
fulfillment_inNoComma-separated FBA/FBM/AMZ to keep on top_asins.
marketplace_idNo1 = Amazon UK, 2 = Amazon US (default)
max_composite_scoreNo
min_composite_scoreNo
max_number_of_ratingsNo
min_number_of_ratingsNo
product_brand_containsNo
product_title_containsNo
distribution_verdict_inNoComma-separated distribution verdicts to keep, e.g. 'DOMINANT SELLER', 'OPEN DISTRIBUTION', 'HIGH BRAND HEAT'. If the brand's verdict isn't in the list, an empty result is returned.
max_fulfillment_amz_dom_pctNo
max_fulfillment_fba_pen_pctNo
min_fulfillment_amz_dom_pctNo
min_fulfillment_fba_pen_pctNo
evaluate_category_for_private_label
Read-only
Inspect

Assess whether a category or niche (ANY depth — e.g. 'Terrariums') is winnable for a NEW private-label brand. Use for 'is X winnable for private label', 'should I private-label X', 'is the X niche good for a new brand', 'can I launch my own brand in X'. Returns a per-signal pass/fail breakdown and a Strong / Moderate / Weak verdict based on Amazon's footprint, seller fragmentation, demand, and price band.

ParametersJSON Schema
NameRequiredDescriptionDefault
verdict_inNoComma-separated verdicts to keep (Strong/Moderate/Weak).
category_idNoExact category id (any depth).
category_nameNoCategory/niche name (any depth, fuzzy).
marketplace_idNo1=UK, 2=US, 3=Walmart. Default 2 (US).
filter_brands_by_fba_share
Read-only
Inspect

Return brands whose FBA buybox share is below or above a threshold. FBA share is computed as fba_buybox_days / total_buybox_days * 100 (percentage, 0-100). Use fba_share < 40 to find FBM-heavy brands (carriers hold real inventory) or fba_share > 80 for FBA-dominated brands. Supports sort by control_score (heat), unique_sellers, or brand_bought_past_month_30d.

ParametersJSON Schema
NameRequiredDescriptionDefault
brandNoExact brand match (case-insensitive).
limitNo
sort_byNoSort column (default control_score).
fba_share_opYesComparison operator for FBA share threshold.
brand_containsNo
marketplace_idYes1 = Amazon UK, 2 = Amazon US (default)
fba_share_valueYesFBA share threshold (0-100, percentage).
max_control_scoreNo
min_control_scoreNo
min_sourcing_scoreNoOptional — minimum control_score (heat) filter.
max_asins_touched_3mNo
max_winner_diversityNo
min_asins_touched_3mNo
min_winner_diversityNo
max_unique_sellers_3mNo
min_unique_sellers_3mNo
max_amz_retail_dominance_pctNo
min_amz_retail_dominance_pctNo
filter_operators_by_fba_share
Read-only
Inspect

Return operators whose FBA buybox share is below or above a threshold. FBA share is 0-100 (percentage). Use fba_share < 50 to find FBM-leaning operators (likely carrying real inventory) or fba_share > 80 for FBA-heavy flippers. Supports optional brand filter to narrow to operators selling a specific brand.

ParametersJSON Schema
NameRequiredDescriptionDefault
brandNoOptional — filter to operators selling this brand.
limitNo
sort_byNoSort column (default buybox_days).
seller_nameNoExact seller/operator name (case-insensitive).
fba_share_opYesComparison operator for FBA share threshold.
marketplace_idYes1 = Amazon UK, 2 = Amazon US (default)
max_avg_ratingNo
min_avg_ratingNo
fba_share_valueYesFBA share threshold (0-100, percentage).
max_asins_touchedNo
min_asins_touchedNo
max_brands_touchedNo
min_brands_touchedNo
max_avg_rating_countNo
max_sold_30d_revenueNo
min_avg_rating_countNo
min_sold_30d_revenueNo
seller_name_containsNo
max_observed_buybox_daysNo
min_observed_buybox_daysNo
find_brands_with_high_seller_churn
Read-only
Inspect

Find brands experiencing high seller churn relative to their category. Returns brands where seller_churn_30d_delta_vs_cat_pp >= the specified threshold (default 5pp). Optionally filtered by category. Use when the user asks about 'brands losing sellers', 'high churn brands', or 'seller instability'.

ParametersJSON Schema
NameRequiredDescriptionDefault
brandNoExact brand match (case-insensitive).
limitNoMax results (capped at 10). Default 10.
scopeNotracked = only brands on the user's watchlist; universe = all brands. Default universe.
categoryNoCategory root name to filter (optional).
max_delta_ppNoMax delta vs category in percentage points. Omit for no ceiling.
min_delta_ppNoMin delta vs category in percentage points. Default 5.
brand_containsNo
marketplace_idNo1 = Amazon UK, 2 = Amazon US (default)
max_seller_churn_30d_pctNo
min_seller_churn_30d_pctNo
max_brand_velocity_90d_units_dayNo
min_brand_velocity_90d_units_dayNo
dominant_category_velocity_tier_inNoComma-separated velocity tiers to keep.
find_deconcentrating_brands
Read-only
Inspect

Find brands where buybox concentration dropped over the last quarter — more sellers are entering, creating opportunity for new entrants. Use when the user asks 'brands losing control', 'deconcentrating brands', 'brands opening up to competition', 'gentrification opportunities', or any question about brands becoming less monopolized.

ParametersJSON Schema
NameRequiredDescriptionDefault
brandNoExact brand match (case-insensitive).
limitNo
since_weeksNoWindow to compare (default 12, max 26). Compares first half vs second half.
brand_containsNo
marketplace_idNo1 = Amazon UK, 2 = Amazon US (default)
max_asin_countNo
min_asin_countNo
min_buybox_daysNoMinimum observed buybox days to filter out inactive brands (default 30).
max_control_scoreNo
min_control_scoreNo
max_new_seller_countNo
max_old_seller_countNo
min_new_seller_countNo
min_old_seller_countNo
max_seller_growth_pctNo
min_seller_growth_pctNo
find_new_operators
Read-only
Inspect

Find operators (sellers) we FIRST OBSERVED selling recently — their earliest observation in our data falls in the window. An observation signal, NOT confirmed market entry: sparse sampling can surface a long-present seller the first time we see them. Different from top_expanding_operators (existing operators adding brands). Use when the user asks 'new sellers this month', 'who just started selling', 'newly seen operators', or any question about emerging/newly-observed sellers.

ParametersJSON Schema
NameRequiredDescriptionDefault
limitNo
min_brandsNoMinimum brands to filter out trivial sellers (default 5).
since_daysNoHow far back to look (default 30, max 180).
seller_nameNoExact seller name (case-insensitive).
marketplace_idNo1 = Amazon UK, 2 = Amazon US (default)
max_avg_ratingNo
min_avg_ratingNo
max_total_asinsNo
min_total_asinsNo
earliest_seen_toNo
earliest_seen_fromNoYYYY-MM-DD lower bound on earliest-seen date.
max_avg_rating_countNo
min_avg_rating_countNo
seller_name_containsNo
max_operator_fba_share_pctNo
min_operator_fba_share_pctNo
max_total_observed_buybox_daysNo
min_total_observed_buybox_daysNo
find_product_across_webInspect

Find where one product sits across the open web — a live cross-retailer price check — with every price anchored to Webotee's independently-observed Amazon buy-box. Give ONE identifier (asin, upc, gtin, or title + brand) and a mode: price_compare (default, all retailers vs the Amazon buy-box), cheaper (only sources below the buy-box), dropship (net margin after estimated Amazon fees), or supplier (wholesale-class sources). Returns each source's price, class, spread vs the buy-box, and a durability read from our 16-month history. The Amazon anchor also carries the product brand, title, and price (or price range) plus its fulfillment (FBA/FBM/AMZ + amz/fba pct). One product per call.

ParametersJSON Schema
NameRequiredDescriptionDefault
upcNoUPC code.
asinNoAmazon ASIN (the strongest anchor).
gtinNoGTIN code.
modeNoprice_compare (default) | cheaper | dropship | supplier.
brandNoBrand (with title).
titleNoProduct title (use with brand to resolve the ASIN).
sourceNoExact merchant/source name (case-insensitive).
max_priceNo
min_priceNoOnly web sources priced >= this.
currency_inNoComma-separated currencies to keep (e.g. USD).
marketplace_idNoMarketplace (2 = Amazon US). Default 2.
source_class_inNoComma-separated source classes to keep (retailer/marketplace/wholesale).
source_containsNo
max_spread_vs_buyboxNo
min_spread_vs_buyboxNo
max_dropship_net_marginNo
min_dropship_net_marginNo
find_single_seller_brands
Read-only
Inspect

Find brands where a single operator controls 100 percent of observed buybox days. These are either gated/exclusive or operator-acquired brands. Use when the user asks 'brands with one seller', 'exclusive brands', 'single-seller brands', 'monopoly brands', or any question about brands with no competition.

ParametersJSON Schema
NameRequiredDescriptionDefault
brandNoExact brand match (case-insensitive).
limitNo
min_asinsNoMinimum ASINs to filter out trivially small brands (default 10).
category_idNoFilter to a specific root category. Omit for all.
max_avg_priceNoMaximum average price in USD. Omit for no cap.
min_avg_priceNoMinimum average price in USD. Omit for no floor.
brand_containsNo
marketplace_idNo1 = Amazon UK, 2 = Amazon US (default)
dominant_sellerNoExact dominant-seller name (case-insensitive).
min_buybox_daysNoMinimum observed buybox days in last 3 months (default 30).
max_control_scoreNo
min_control_scoreNo
dominant_seller_containsNo
find_sourcing_opportunities
Read-only
Inspect

Given an Amazon ASIN, diagnose its business model (private-label / wholesale / arbitrage) and find real-world supplier, wholesale and arbitrage matches across the web, then return an HONEST sourcing read: a viability qualifier (green/yellow/red), the specific move + required differentiation, conservative economics, named risks (IP, tariffs, MOQ, saturation, gating, dropship policy) and validation steps. A credible lead generator, not get-rich advice. Scout+.

ParametersJSON Schema
NameRequiredDescriptionDefault
asinYesThe Amazon ASIN (10 chars).
marketplace_idNoMarketplace (2 = US). Default 2.
find_undercompeted_brands
Read-only
Inspect

Find brands with low seller competition but real sales presence. The flagship sourcing discovery tool. Use when the user asks 'find brands with few sellers', 'low competition brands', 'undercompeted brands under $50', 'brands I could source with little competition', or any variant of 'find me something to sell'. Pass seed_brand when user mentions a reference brand ('brands like Ninja', 'low competition in the same category as OXO') to constrain results to the same root category.

ParametersJSON Schema
NameRequiredDescriptionDefault
brandNoExact brand match (case-insensitive).
limitNo
seed_brandNoReference brand to derive category from. Results stay in the same root category.
category_idNoFilter to a specific root category ID. Overrides seed_brand if both given.
max_sellersNoMaximum unique sellers (competition ceiling). Default 20.
min_sellersNoMinimum unique sellers (default 10). Drops single-seller / brand-owner-only 'PL junk' so results show proven multi-seller demand (the default 10–20 window: under-competed but real).
max_avg_priceNoMaximum average buybox price in USD. Omit for no price filter.
min_avg_priceNoMinimum average buybox price in USD. Omit for no price filter.
brand_containsNo
marketplace_idNo1 = Amazon UK, 2 = Amazon US (default)
max_asin_countNo
min_asin_countNo
min_buybox_daysNoMinimum observed buybox days in last 3 months (sales floor). Default 30.
include_catchallNoInclude reseller umbrella brands (PATIKIL, Uxcell, etc.). Default false.
max_velocity_90dNo
min_velocity_90dNo
max_control_scoreNo
min_control_scoreNo
find_underserved_niches
Read-only
Inspect

Find UNDER-SERVED NICHES — real SUBCATEGORIES with genuine demand but room to compete, ranked by private-label winnability from 2-year marketplace data. Returns CATEGORIES / sub-categories (e.g. 'Wireless Earbuds', 'Cable Organizers'), NEVER brands. This is the RIGHT tool for ANY niche-discovery question: 'under-served niches', 'niches in ', 'find a niche to enter', 'what niche should I sell in', 'underserved categories', 'gaps in ', 'where's the opportunity in '. When the user names a department or category (e.g. 'electronics', 'home & kitchen'), pass it as category_name to scope the niches to that area. Do NOT use category_undercompeted_brands or find_undercompeted_brands for niche questions — those return BRANDS, not niches.

ParametersJSON Schema
NameRequiredDescriptionDefault
limitNo
nicheNoExact niche (subcategory) name, case-insensitive.
price_maxNoMaximum average price USD (default 70 — the PL margin band).
price_minNoMinimum average price USD (default 20 — the PL margin band).
category_idNoRoot category id to scope to (overrides category_name).
competitionNo'low' (stricter Amazon-presence ceiling) or 'balanced' (default).
category_nameNoDepartment/category to find niches within (e.g. 'electronics', 'home & kitchen', 'pet supplies'). Omit for niches across all departments.
marketplace_idNo1 = Amazon UK, 2 = Amazon US (default)
niche_containsNo
unhappy_shoppersNoBias toward niches where shoppers are underwhelmed (a credible dissatisfaction gap = a PL opening). Default false.
pl_winnability_inNoComma-separated verdicts to keep (Strong/Moderate/Weak).
max_competing_brandsNo
max_seller_diversityNo
min_competing_brandsNo
min_seller_diversityNo
max_avg_product_ratingNo
max_monthly_demand_usdNo
min_avg_product_ratingNo
min_monthly_demand_usdNo
max_amazon_retail_share_pctNo
min_amazon_retail_share_pctNo
gating_repricing_advice
Read-only
Inspect

Recommend ungate / arbitrage / avoid for an ASIN, with a 3-bullet rationale citing named metrics (gating_score, amz_retail_dominance_pct, fba_pct, brand_posture). Also returns the ASIN's product brand, title and price (or price range) plus fulfillment (FBA/FBM/Amazon). Use for 'should I try to ungate this?' / 'how should I price this?'.

ParametersJSON Schema
NameRequiredDescriptionDefault
asinYes
marketplace_idNo1 = Amazon UK, 2 = Amazon US (default)
map_violations_today
Read-only
Inspect

Show active MAP (Minimum Advertised Price) violations for products in the workspace. Use when the user asks 'MAP violations', 'who is selling below MAP', 'price violations today', 'are there any MAP breaches', or any MAP-enforcement question.

ParametersJSON Schema
NameRequiredDescriptionDefault
brandNoFilter to a specific brand. Omit for all workspace brands.
limitNo
last_seen_toNo
first_seen_toNo
retailer_nameNoExact retailer name (case-insensitive).
brand_containsNoSubstring match on brand (use `brand` for an exact match).
last_seen_fromNo
first_seen_fromNoYYYY-MM-DD.
retailer_domainNoExact retailer domain (case-insensitive).
max_map_floor_usdNo
max_violation_pctNoMaximum violation percentage below MAP.
min_map_floor_usdNo
min_violation_pctNoMinimum violation percentage below MAP (default 0, meaning any violation).
max_observed_price_usdNo
min_observed_price_usdNo
product_title_containsNo
retailer_name_containsNo
retailer_domain_containsNo
my_competitors
Read-only
Inspect

Who's competing with the seller on their OWN products. Pass an ASIN from your catalog to see the full competitor list for that listing (who wins the buy-box, FBA/FBM, observed price, how long they've been on it) plus your own buy-box / undercut status. Omit the ASIN to get your most-contested products (most competing sellers / where you're being undercut). Requires a connected store (Starter+). Use for 'who am I competing with', 'am I losing the buy-box', 'who else sells B0...', 'where am I under pressure'.

ParametersJSON Schema
NameRequiredDescriptionDefault
asinNoOptional — a specific ASIN from your catalog.
marketplace_idNo1 = Amazon UK, 2 = Amazon US (default)
my_opportunities
Read-only
Inspect

What to source NEXT, adjacent to what the seller already sells. Seeds Webotee's undercompeted-brand and underserved-niche engines from the seller's OWN connected catalog (their dominant brands and categories), excluding brands they already carry. Requires a connected store (Starter+). Use for 'what should I source next', 'expand my catalog', 'adjacent opportunities', 'what else could I sell'.

ParametersJSON Schema
NameRequiredDescriptionDefault
marketplace_idNo1 = Amazon UK, 2 = Amazon US (default)
my_products
Read-only
Inspect

The seller's OWN connected Amazon catalog fused with Webotee market intelligence. Each product shows EXACT account data (your price, your inventory, FBA/FBM, listing status) alongside OBSERVED/ESTIMATED market data (sourcing score, the observed market buy-box price, how many sellers are on the listing, estimated 30-day units, cross-marketplace spread) and a price_vs_market read (below_market / at_market / above_market). Requires a connected store (Starter+). Use when the seller asks about their own products, 'how am I priced vs the market', 'which of my products are under pressure', or 'show my catalog'.

ParametersJSON Schema
NameRequiredDescriptionDefault
sortNoOrdering: score (default), undercut, price, inventory.score
brandNoOptional — only products of this brand.
marketplace_idNo1 = Amazon UK, 2 = Amazon US (default)
my_store
Read-only
Inspect

Store-level summary of the seller's connected Amazon catalog: number of products tracked, distinct brands, FBA vs FBM split, total on-hand inventory units (EXACT, from the account), average Webotee sourcing score, how many products are currently undercut, and how many have a cross-marketplace (Walmart) opportunity. Requires a connected store (Starter+). Use for 'how is my store doing', 'summarise my catalog', or a dashboard overview.

ParametersJSON Schema
NameRequiredDescriptionDefault
marketplace_idNo1 = Amazon UK, 2 = Amazon US (default)
operator_brands_by_competition
Read-only
Inspect

Given one or more operator (seller) names, return the brands they carry ranked by seller competition level. Use when the user asks 'which brands sold by these operators have the least competition', 'out of these operators, show me brands with fewest sellers', 'low-competition brands for operator X', or any follow-up that chains operator names to brand-level competition metrics.

ParametersJSON Schema
NameRequiredDescriptionDefault
sortNoSort by competitor count: 'asc' (least competition first, default) or 'desc'.
brandNoExact brand (case-insensitive).
limitNo
brand_containsNo
marketplace_idNo1 = Amazon UK, 2 = Amazon US (default)
max_asin_countNo
min_asin_countNo
operator_namesYesList of seller/operator names to look up.
max_competitor_countNo
min_competitor_countNo
max_operator_fba_share_pctNo
min_operator_fba_share_pctNo
max_observed_buybox_days_3mNo
min_observed_buybox_days_3mNo
operator_buybox_losses
Read-only
Inspect

For ONE operator (seller), find the ASINs where it's losing the buy-box — it carries the listing but holds less than max_buybox_share_pct of the buy-box — ranked by estimated 30-day revenue at risk. Each leak returns who's winning the box, the operator's vs the winner's sanitized price and the gap, how many sellers are on the listing, a situation (price_gap | tied_price | amazon_in_box | reseller_swarm), a suggested_action (reprice_to_win | enable_fba | defend_match_only | evaluate_or_exit), and a suggested_target_price when the box is winnable on price. Totals include the recoverable price-gap-only revenue. Use when the user asks 'where is seller X losing the buy-box', 'X's buy-box leaks', 'which ASINs should X reprice', 'where is X leaving money on the table', or 'what's X's revenue at risk'. Sortable by revenue-at-risk (default), price gap, buy-box share, or listing revenue.

ParametersJSON Schema
NameRequiredDescriptionDefault
sortNoSort the leaks: revenue_at_risk (default), price_gap_pct (biggest recoverable gap), buybox_share (lowest first), or listing_revenue.
limitNoLeaks to return (default 25, max 100). This tool pages.
min_priceNoOnly ASINs whose listing price >= this (skip pennies).
situation_inNoComma-separated situations to keep (price_gap, tied_price, amazon_in_box, reseller_swarm).
operator_nameYesSeller/operator name.
fulfillment_inNoComma-separated operator fulfillment to keep (FBA, FBM).
marketplace_idNo1 = Amazon UK, 2 = Amazon US (default).
min_est_revenue_30dNoOnly ASINs with estimated 30-day listing revenue >= this.
max_buybox_share_pctNoOnly ASINs where the operator holds LESS than this share of the buy-box (0-1; default 0.75 — i.e. it's not dominating).
exclude_amazon_in_boxNoDrop ASINs where Amazon holds the box (you can't win those).
operator_category_dominance
Read-only
Inspect

Show which product categories an operator dominates. Returns categories ranked by the operator's brand count and observed buybox days in each. Use when the user asks 'what categories does this seller focus on', 'operator category breakdown', 'where does Amazon Warehouse dominate', or any category-scoped operator question.

ParametersJSON Schema
NameRequiredDescriptionDefault
limitNo
category_nameNoExact category name (case-insensitive).
operator_nameYesSeller/operator name.
marketplace_idNo1 = Amazon UK, 2 = Amazon US (default)
max_brand_countNo
max_total_asinsNo
min_brand_countNo
min_total_asinsNo
category_name_containsNo
max_total_observed_buybox_daysNo
min_total_observed_buybox_daysNo
operator_classifier
Read-only
Inspect

Label what kind of operator a seller is — amazon, brand-direct, likely-authorized-retailer, arbitrage, or reseller — from our cross-brand operator signals (how many brands they span, their fulfilment mix, their primary brand). Use when the user asks 'what kind of seller is this', 'is this an authorized retailer or an arbitrage seller', 'classify this operator'. Heuristic label, not a legal determination. Amazon US/UK.

ParametersJSON Schema
NameRequiredDescriptionDefault
operator_nameYesSeller/operator name.
marketplace_idNo1 = Amazon UK, 2 = Amazon US (default)
operator_compare
Read-only
Inspect

ASIN-level buy-box head-to-head between two operators (sellers). For the ASINs BOTH carry (contested), returns who holds the buy-box (winner), each operator's buy-box share, their sanitized average prices and the price gap, how many OTHER sellers are on the listing, whether Amazon holds the box, and a situation tag (amazon_in_box | reseller_swarm | tied_price | price_gap) — plus operator_a's estimated 30-day revenue-at-risk. Also returns each side's WHITESPACE: high-revenue ASINs that operator wins which the OTHER doesn't carry (expansion targets). Use when the user asks 'compare seller A vs seller B', 'where do these two sellers overlap / compete', 'who wins the buy-box between them', 'show me the head-to-head', or 'what does A sell that B doesn't'. Sortable by revenue-at-risk (default), price gap, or share gap.

ParametersJSON Schema
NameRequiredDescriptionDefault
sortNoSort the contested list: revenue_at_risk (operator_a's 30d revenue at risk, default), price_gap (abs A-vs-B price gap), or share_gap (abs buy-box share gap).
brandNoOptional — scope the comparison to a single brand's ASINs (catalog sizes, contested, and whitespace are all limited to that brand). Omit for all brands.
limitNoContested ASINs to return (default 25, max 100). This tool pages.
operator_aYesFirst operator/seller name (the focal seller — revenue-at-risk + situation are from A's view).
operator_bYesSecond operator/seller name.
contested_onlyNoIf true, skip the whitespace sections (only the head-to-head contested list).
marketplace_idNo1 = Amazon UK, 2 = Amazon US (default).
whitespace_forNoWhich side's whitespace to compute (default both).
include_whitespaceNoInclude each side's whitespace ASINs (default true).
min_est_revenue_30dNoOnly contested ASINs with estimated 30-day listing revenue >= this.
operator_concentration
Read-only
Inspect

Operator concentration (HHI) across a set of ASINs or a brand's catalog — reveals when the same operator quietly controls many of the 'independent' listings. Returns the HHI, a concentration label, and the top operators with how many listings each dominates. Use for private-label fragmentation checks: 'how concentrated is this niche', 'who controls this brand's listings', 'is one operator running most of these'. Amazon US/UK. Optional filters (all default to no filter): min/max hhi (gates the whole analysis by its concentration index); on the top_operators list — operator (exact, case-insensitive) + operator_contains, min/max share_pct, min/max listings_controlled.

ParametersJSON Schema
NameRequiredDescriptionDefault
asinsNoASIN set to analyze.
brandNoOr a brand whose catalog to analyze.
limitNo
max_hhiNo
min_hhiNoOnly return the analysis if its HHI >= this (else empty top_operators).
operatorNoKeep only this operator (exact, case-insensitive) in top_operators.
max_share_pctNo
min_share_pctNo
marketplace_idNo1 = Amazon UK, 2 = Amazon US (default)
operator_containsNo
max_listings_controlledNo
min_listings_controlledNo
operator_lost_brands
Read-only
Inspect

Show brands an operator recently stopped selling (churn signal). Use when the user asks 'what brands did this seller drop', 'operator churn', 'brands lost by X', or any question about an operator shrinking their catalog.

ParametersJSON Schema
NameRequiredDescriptionDefault
brandNoExact brand (case-insensitive).
limitNo
since_daysNoWindow to compare (default 30, max 180). Brands present before but absent in the last since_days.
first_seen_toNo
operator_nameYesSeller/operator name.
brand_containsNo
marketplace_idNo1 = Amazon UK, 2 = Amazon US (default)
first_seen_fromNo
last_seen_week_toNo
last_seen_week_fromNoYYYY-MM-DD lower bound on last_seen_week.
operator_new_brands
Read-only
Inspect

Show brands an operator recently started selling. Use when the user asks 'what new brands did this seller pick up', 'operator new brands', 'what is Amazon Warehouse selling now that it wasn't before', or any question about an operator expanding their catalog.

ParametersJSON Schema
NameRequiredDescriptionDefault
brandNoExact brand (case-insensitive).
limitNo
since_daysNoHow far back to look for new brands (default 30, max 180).
first_seen_toNo
operator_nameYesSeller/operator name.
brand_containsNo
marketplace_idNo1 = Amazon UK, 2 = Amazon US (default)
first_seen_fromNoYYYY-MM-DD lower bound on first_seen.
operator_new_on_brand
Read-only
Inspect

Operators newly OBSERVED on a brand in a recent window — counted at BRAND level: a seller's FIRST observation anywhere across the brand's ASINs falls in the window. This is coverage-robust (a long-present seller was almost certainly seen on some ASIN earlier, so they correctly drop out) — a trustworthy directional 'new on the brand' count, not the inflated per-ASIN number. Still first-OBSERVED, not provably first-to-market. Returns each operator with first_observed, how many of the brand's ASINs we've seen them on, and whether still active. Use for 'who's new on ', 'who's newly showing up on my brand', 'recent sellers on '. Amazon US/UK. since_days already bounds first_observed below; optional filters (all default to no filter): operator (exact, case-insensitive) + operator_contains, first_observed_from/_to, min/max n_asins_on_brand, min/max total_days_seen, min/max observed_buybox_days, still_active (true/false).

ParametersJSON Schema
NameRequiredDescriptionDefault
brandYesThe brand to watch.
limitNo
operatorNoExact operator/seller name (case-insensitive).
since_daysNoWindow in days (default 30, max 180).
still_activeNoKeep only operators last seen within 7 days (true) or not (false).
marketplace_idNo1 = Amazon UK, 2 = Amazon US (default)
first_observed_toNo
operator_containsNo
first_observed_fromNoYYYY-MM-DD lower bound on first_observed.
max_total_days_seenNo
min_total_days_seenNo
max_n_asins_on_brandNo
min_n_asins_on_brandNo
max_observed_buybox_daysNo
min_observed_buybox_daysNo
operator_resells_what
Read-only
Inspect

The arbitrage sourcing feed: given an ASIN (or a seller/operator name), find the OTHER ASINs the operators on that listing also resell, ranked by sourcing fit (our composite sourcing score) then estimated 30-day sales. De-duped against the ASINs the user already tracks, so it surfaces NEW candidates. Use when the user says 'what else does this seller carry', 'find more like this from the same operators', 'arbitrage leads from this ASIN's sellers'. Each candidate ASIN also carries product brand, title, and price (or price range) plus its fulfillment (FBA/FBM/AMZ + amz/fba pct). Amazon US/UK. Optional filters (all default to no filter): min/max sourcing_score, est_units_30d, buybox_avg_price; resold_by_contains; the shared product/fulfillment block (product_brand, product_title_contains, min/max_price, fulfillment_in, amz/fba pct).

ParametersJSON Schema
NameRequiredDescriptionDefault
asinNoAn ASIN whose operators to expand from.
limitNo
max_priceNo
min_priceNo
operator_nameNoOr a seller/operator name directly.
product_brandNoExact product brand (case-insensitive).
fulfillment_inNoComma-separated FBA/FBM/AMZ to keep.
marketplace_idNo1 = Amazon UK, 2 = Amazon US (default)
max_est_units_30dNo
min_est_units_30dNo
max_sourcing_scoreNo
min_sourcing_scoreNoOnly candidates with sourcing score >= this.
resold_by_containsNoKeep candidates resold by a seller whose name contains this.
max_buybox_avg_priceNo
min_buybox_avg_priceNo
product_brand_containsNo
product_title_containsNo
max_fulfillment_amz_dom_pctNo
max_fulfillment_fba_pen_pctNo
min_fulfillment_amz_dom_pctNo
min_fulfillment_fba_pen_pctNo
operator_top_asins
Read-only
Inspect

Show the ASINs an operator wins the buybox on most often, ranked by ESTIMATED 30-day sales by default. For each ASIN it returns the operator's estimated units sold and revenue in the last 30 days (est_units_30d, est_revenue_30d — the product's sales estimate weighted by the operator's buy-box share) plus the operator's BUYBOX SHARE (percent of observed days it held the buybox; normalized, not raw days). Sortable by est_sales (default), observed buybox days won, price, or days seen. Use when the user asks 'what ASINs does this seller win on', 'top ASINs for operator X', 'what does this seller sell the most of', 'best products for this seller', or any ASIN-level operator drill-down. Each ASIN also carries product brand, title, and price (or price range) plus its fulfillment (FBA/FBM/AMZ + amz/fba pct).

ParametersJSON Schema
NameRequiredDescriptionDefault
asinNoExact ASIN match.
sortNoSort order: est_sales (estimated 30-day revenue, default), buybox_days (observed buybox days won), price, or days_seen.
limitNoNumber of ASINs to return (default 10, max 50).
max_priceNo
min_priceNo
est_basis_inNoComma-separated sales-estimate sources to keep.
last_seen_toNo
asin_containsNo
first_seen_toNo
max_days_seenNo
min_days_seenNo
operator_nameYesSeller/operator name.
product_brandNoExact product brand (case-insensitive).
fulfillment_inNoComma-separated FBA/FBM/AMZ to keep.
last_seen_fromNo
marketplace_idNo1 = Amazon UK, 2 = Amazon US (default)
first_seen_fromNoYYYY-MM-DD.
max_est_units_30dNo
min_est_units_30dNo
max_est_revenue_30dNo
min_est_revenue_30dNo
max_buybox_avg_priceNo
max_buybox_share_pctNo
min_buybox_avg_priceNo
min_buybox_share_pctNoOnly ASINs where the operator's buybox share >= this.
product_brand_containsNo
product_title_containsNo
max_observed_buybox_daysNo
min_observed_buybox_daysNo
max_fulfillment_amz_dom_pctNo
max_fulfillment_fba_pen_pctNo
min_fulfillment_amz_dom_pctNo
min_fulfillment_fba_pen_pctNo
operator_top_brands
Read-only
Inspect

Show the brands an operator sells the most of, ranked by ESTIMATED 30-day sales by default. For each brand the operator carries it returns the operator's estimated units sold and revenue in the last 30 days (est_units_30d, est_revenue_30d — the estimated sales of the ASINs the operator wins for that brand, weighted by its buy-box share), the number of the brand's ASINs the operator wins, and observed buybox days. Use when the user asks 'what brands does this seller sell the most of', 'top brands for operator X', 'which brands make this seller the most money', or any brand-level operator drill-down by sales. For brand competition (fewest sellers) instead of sales, use operator_brands_by_competition.

ParametersJSON Schema
NameRequiredDescriptionDefault
sortNoSort order: est_sales (estimated 30-day revenue, default), est_units, buybox_days (observed buybox days), or asin_count.
brandNoExact brand (case-insensitive).
limitNo
operator_nameYesSeller/operator name.
brand_containsNo
marketplace_idNo1 = Amazon UK, 2 = Amazon US (default)
max_asin_countNo
min_asin_countNo
max_est_units_30dNo
min_est_units_30dNo
max_est_revenue_30dNo
min_est_revenue_30dNo
max_observed_buybox_daysNo
min_observed_buybox_daysNo
operator_xmarket_presence
Read-only
Inspect

Check whether an operator sells on Amazon US, Amazon UK, and/or Walmart. Returns per-marketplace brand count, ASIN count, and observed buybox days. Use when the user asks 'does this seller sell on Walmart too', 'cross-marketplace presence', 'is this operator on Amazon UK', or any multi-marketplace operator question.

ParametersJSON Schema
NameRequiredDescriptionDefault
operator_nameYesSeller/operator name.
playbook_createInspect

Save a reusable per-model research workflow (a 'playbook') the user can re-run or schedule. Provide a template_key (one of: brand_watch, new_brand_radar, replenishment_watch, arbitrage_feed, defend_my_niche, find_my_next_niche, brand_defense_daily, expansion_radar, dropship_watch, spread_hunter, map_sweep, operator_network_expose, gating_risk_guardian) with its scope, OR custom steps. scope holds the inputs every step shares (e.g. {"brand":"Nike"} or an ASIN). Use when the user says 'save this as a weekly check', 'make a playbook for ...', 'automate this research'.

ParametersJSON Schema
NameRequiredDescriptionDefault
nameYesThe playbook's label.
scopeNoShared inputs for the steps, e.g. {"brand":"Nike"}.
stepsNoCustom ordered [{tool,args}] (instead of a template).
scheduleNoRun cadence (default = template's or manual).
template_keyNoBuilt-in template to seed from.
playbook_list
Read-only
Inspect

List the workspace's saved playbooks (name, schedule, last run) and the built-in templates available. Use when the user asks 'what playbooks do I have', 'show my saved workflows', 'what automations are set up'.

ParametersJSON Schema
NameRequiredDescriptionDefault
activeNoOnly active (true) or only paused (false) playbooks.
schedule_inNoComma-separated cadences to keep (manual/daily/weekly).
last_run_at_toNo
template_key_inNoComma-separated template keys to keep.
last_run_at_fromNoYYYY-MM-DD; only playbooks last run on/after this.
playbook_run_nowInspect

Run a saved playbook right now and return its digest (also saved to the in-app inbox). Use when the user says 'run my playbook', 'check my brand watch now', 'run that workflow'.

ParametersJSON Schema
NameRequiredDescriptionDefault
nameYes
playbook_scheduleInspect

Set how often a saved playbook runs automatically (manual, daily, or weekly). Use when the user says 'run this weekly', 'schedule my playbook daily', 'stop the automatic runs' (manual).

ParametersJSON Schema
NameRequiredDescriptionDefault
nameYes
scheduleYes
risk_assessment
Read-only
Inspect

Risk + protection assessment for an ASIN or brand. Returns composite risk score (0-100), recent MAP violation events (≤10, each with the offending ASIN's product brand, title, price or price range and fulfillment FBA/FBM/Amazon), unauthorized seller list (≤10), and 1-3 recommended actions. Use for 'flag risk events on my brand' or 'is this ASIN risky?' style prompts.

ParametersJSON Schema
NameRequiredDescriptionDefault
asinNo
daysNoLookback window for MAP events. Default 30.
brandNo
kind_inNoComma-separated flagged-event kinds to keep (e.g. map_violations,amazon_dominated).
max_countNo
max_priceNo
min_countNo
min_priceNo
severity_inNoComma-separated severities to keep (high/medium/low).
buybox_sellerNoExact offending buy-box seller (case-insensitive).
event_date_toNo
product_brandNoExact product brand (case-insensitive).
fulfillment_inNoComma-separated FBA/FBM/AMZ to keep.
marketplace_idNo1 = Amazon UK, 2 = Amazon US (default)
event_date_fromNoYYYY-MM-DD.
max_listed_priceNo
min_listed_priceNo
buybox_seller_containsNo
product_brand_containsNo
product_title_containsNo
max_fulfillment_amz_dom_pctNo
max_fulfillment_fba_pen_pctNo
min_fulfillment_amz_dom_pctNo
min_fulfillment_fba_pen_pctNo
search_products
Read-only
Inspect

Free-text keyword search over Amazon product titles + descriptions. Use when the user names a PRODUCT TYPE or keywords (e.g. 'stainless steel water bottle', 'cat litter box', 'magnetic phone mount') rather than a specific brand, category, or ASIN. Returns the top matching products ranked by relevance with brand, price, 30-day demand, fulfillment (FBA/Amazon/FBM) and rating. Optional filters narrow the result by any returned field: product_brand, min/max_price, fulfillment_in (FBA/FBM/AMZ), min/max demand, and min/max rating.

ParametersJSON Schema
NameRequiredDescriptionDefault
keywordsYesFree-text product keywords, e.g. 'stainless steel water bottle'.
max_priceNo
min_priceNo
max_ratingNo
min_ratingNo
product_brandNoExact product brand (case-insensitive).
fulfillment_inNoComma-separated FBA/FBM/AMZ to keep.
marketplace_idNo1 = Amazon UK, 2 = Amazon US (default). Amazon only.
max_rating_countNo
min_rating_countNo
max_demand_units_30dNo
min_demand_units_30dNo
max_demand_revenue_30dNo
min_demand_revenue_30dNo
product_brand_containsNo
max_fulfillment_amz_dom_pctNo
max_fulfillment_fba_pen_pctNo
min_fulfillment_amz_dom_pctNo
min_fulfillment_fba_pen_pctNo
set_cost_floorInspect

Record the user's cost basis (landed unit cost) for an ASIN so later checks can flag when the buy box drops below their cost and compute true net spread; the saved/cleared confirmation also echoes the ASIN's product brand, title and price (or price range) and its fulfillment (FBA/FBM/AMZ). Use when the user says 'my cost on B0... is $12', 'set my cost basis', 'I pay $X for this'. One ASIN per call; pass cost 0 to clear.

ParametersJSON Schema
NameRequiredDescriptionDefault
asinYesThe 10-character ASIN.
cost_floorYesYour landed unit cost (marketplace currency). 0 clears it.
marketplace_idNoMarketplace (2 = Amazon US).
top_expanding_operators
Read-only
Inspect

Find sellers (operators) expanding into the most NEW brands in a recent window. Use when the user asks 'operators expanding into new brands', 'sellers growing fastest by brand count', 'who is moving into new brands this month', or any cross-cutting operator question without a specific seller named.

ParametersJSON Schema
NameRequiredDescriptionDefault
limitNo
seller_nameNoExact seller/operator name (case-insensitive).
window_daysNoDays back for 'new' brands (default 30, max 90).
marketplace_idNo1 = Amazon UK, 2 = Amazon US (default)
max_avg_ratingNo
min_avg_ratingNo
min_new_brandsNoMinimum new-brand count to surface (default 3).
max_total_asinsNo
min_total_asinsNo
max_total_brandsNo
min_total_brandsNo
max_avg_rating_countNo
min_avg_rating_countNo
seller_name_containsNo
max_new_brands_in_windowNo
max_operator_fba_share_pctNo
min_operator_fba_share_pctNo
max_total_observed_buybox_daysNo
min_total_observed_buybox_daysNo
top_sourcing_picks
Read-only
Inspect

Find top sourcing-pick ASINs across the entire catalog with optional filters: max retail price, min retail price, category, brand, exclude gated, exclude Amazon private label. Use when the user asks 'top sourcing picks', 'best ASINs to source', 'ASINs under $X with rising demand', 'fastest growing ASINs', or any cross-cutting question where they have NOT named a specific entity yet. Each pick carries product brand, title and price (or price range) plus fulfillment (FBA/FBM/Amazon) alongside the sourcing scores.

ParametersJSON Schema
NameRequiredDescriptionDefault
asinNoExact ASIN match.
brandNo
limitNoNumber of products to return (default 10, max 50).
scopeNotracked = only ASINs from brands on the user's watchlist; universe = all. Default universe.
categoryNo
max_ratingNo
min_ratingNo
asin_containsNo
exclude_gatedNo
fulfillment_inNoComma-separated FBA/FBM/AMZ to keep.
marketplace_idNo1 = Amazon UK, 2 = Amazon US (default)
max_retail_priceNo
min_retail_priceNo
exclude_amazon_plNo
max_margin_signalNo
min_margin_signalNo
min_velocity_scoreNoMinimum velocity sub-score (0-100). >=90 = 'rising demand' (top ~3%%), >=70 = 'moderate growth' (top ~10%%). >=50 covers 97%% of ASINs and is not a meaningful filter.
max_composite_scoreNo
min_composite_scoreNo
max_sold_30d_revenueNo
min_sold_30d_revenueNo
max_gating_risk_scoreNo
max_number_of_ratingsNo
min_gating_risk_scoreNo
min_number_of_ratingsNo
product_title_containsNoKeyword title search across the WHOLE catalog (FULLTEXT, token-AND any order — may also match the product description), ranked by sourcing score. Broader recall than a literal substring: 'ceiling fan mount' matches titles containing all three words in any order.
max_fulfillment_amz_dom_pctNo
max_fulfillment_fba_pen_pctNo
min_fulfillment_amz_dom_pctNo
min_fulfillment_fba_pen_pctNo
top_velocity_brands
Read-only
Inspect

Find top brands by 90-day unit velocity (brand_velocity_90d_units_day). Optional filters: scope (tracked = user's watchlist, universe = all), category, minimum velocity, exclude Amazon private label, exclude gated. Use when the user asks 'fastest selling brands', 'top velocity brands', 'brands I track by velocity', 'what brands move the most units?', or 'best selling brands in [category]'. When the user says 'my brands' or 'brands I track', set scope=tracked.

ParametersJSON Schema
NameRequiredDescriptionDefault
brandNoExact brand match (case-insensitive).
limitNoMax results (capped at 10). Default 10.
scopeNotracked = only brands on the user's watchlist; universe = all brands. Default universe.
categoryNoCategory root name to filter (optional).
min_velocityNoMinimum units/day threshold (optional).
exclude_gatedNoExclude brands gated to 3P sellers. Default true.
brand_containsNo
marketplace_idNo1 = Amazon UK, 2 = Amazon US (default)
exclude_amazon_plNoExclude Amazon private label brands. Default true.
max_control_scoreNo
min_control_scoreNo
max_sold_30d_revenueNo
max_winner_diversityNo
min_sold_30d_revenueNo
min_winner_diversityNo
max_seller_churn_30d_pctNo
min_seller_churn_30d_pctNo
max_pct_asins_gated_to_3pNo
min_pct_asins_gated_to_3pNo
dominant_category_velocity_tier_inNoComma-separated velocity tiers to keep.
max_seller_churn_30d_delta_vs_cat_ppNo
min_seller_churn_30d_delta_vs_cat_ppNo
unauthorized_sellers
Read-only
Inspect

List the sellers winning a brand's buy box — the resellers and arbitrage operators you're up against — each classified (authorized-retailer / arbitrage / Amazon / brand-direct / reseller). If you've saved an authorized list (authorized_seller_set) it instead flags the UNAUTHORIZED sellers. Use when the user asks 'which operators dominate the buy box on ', 'who else is selling my brand', 'unauthorized sellers on Nike', 'find rogue sellers', or any brand buy-box / protection question.

ParametersJSON Schema
NameRequiredDescriptionDefault
brandYesBrand name (case-insensitive).
limitNo
seller_nameNoExact seller name (case-insensitive).
last_seen_toNo
first_seen_toNo
max_avg_priceNo
min_avg_priceNo
last_seen_fromNo
marketplace_idNo1 = Amazon UK, 2 = Amazon US (default)
first_seen_fromNoYYYY-MM-DD.
operator_type_inNoComma-separated classifications to keep (cold path only, when no authorized list is set): e.g. arbitrage, reseller, amazon, brand-direct, authorized-retailer.
max_asins_touchedNo
min_asins_touchedNo
authorized_sellersNoOptional. Authorized seller names — sellers NOT in this list are flagged. If omitted (and none saved), all buy-box-winning sellers are returned, classified.
seller_name_containsNo
max_observed_buybox_daysNo
min_observed_buybox_daysNo
watchlist_addInspect

Create or add to a saved tracking list the user can monitor over time. list_type is one of asin, brand, seller, niche; name is the user's label for the list; items are the identifiers to track (ASINs, brand names, seller names, or niche keys). Captures a baseline of the current observed state so a later 'what changed' check can show new sellers and score moves. Use when the user says 'track these ASINs', 'add Nike to my brand watchlist', 'start monitoring ...'.

ParametersJSON Schema
NameRequiredDescriptionDefault
nameYesThe list's label (e.g. 'Q4 arbitrage candidates').
itemsYesIdentifiers to add.
list_typeYesasin | brand | seller | niche
marketplace_idNoMarketplace (2 = Amazon US).
watchlist_add_rule
Read-only
Inspect

Resolve a natural-language watchlist request into concrete ASINs the user can add. Use when the user says 'watch this brand', 'alert me when X loses a seller', 'add Nike to my watchlist', or any watchlist-creation intent. Returns matching ASINs with current scores plus product identity (brand, title, price or price range) and fulfillment (FBA/FBM/AMZ with amz/fba share) so the user can confirm which to add.

ParametersJSON Schema
NameRequiredDescriptionDefault
asinNoSpecific ASIN to add. If provided, brand is ignored.
brandNoBrand name to find watchable ASINs for.
limitNo
max_priceNo
min_priceNo
asin_containsNo
fulfillment_inNoComma-separated FBA/FBM/AMZ to keep.
marketplace_idNo1 = Amazon UK, 2 = Amazon US (default)
max_composite_scoreNo
min_composite_scoreNoOnly candidates with sourcing composite score >= this.
max_buybox_avg_priceNo
min_buybox_avg_priceNo
product_title_containsNo
max_observed_buybox_daysNo
min_observed_buybox_daysNo
max_fulfillment_amz_dom_pctNo
max_fulfillment_fba_pen_pctNo
min_fulfillment_amz_dom_pctNo
min_fulfillment_fba_pen_pctNo
watchlist_delta
Read-only
Inspect

Show what changed on the user's sourcing watchlist since last check. Returns each tracked ASIN with its score delta plus product identity (brand, title, price or price range) and fulfillment (FBA/FBM/AMZ with amz/fba share). Use when the user asks 'what changed on my watchlist', 'watchlist updates', 'any changes this week', or any watchlist-status question.

ParametersJSON Schema
NameRequiredDescriptionDefault
asinNoExact ASIN match.
limitNo
max_priceNo
min_priceNo
since_daysNoHow far back to look for changes (default 7, max 30).
asin_containsNo
product_brandNoExact product brand (case-insensitive).
fulfillment_inNoComma-separated FBA/FBM/AMZ to keep.
marketplace_idNoMarketplace to scope to: 1 = Amazon UK, 2 = Amazon US (default), 3 = Walmart US. One marketplace per call.
max_score_deltaNo
min_score_deltaNo
max_current_scoreNo
min_current_scoreNoOnly tracked ASINs with current sourcing score >= this.
max_previous_scoreNo
min_previous_scoreNo
product_brand_containsNo
product_title_containsNo
max_fulfillment_amz_dom_pctNo
max_fulfillment_fba_pen_pctNo
min_fulfillment_amz_dom_pctNo
min_fulfillment_fba_pen_pctNo
watchlist_diff
Read-only
Inspect

Show what changed on a saved tracking list versus its captured baseline — new sellers observed on the tracked ASINs and sourcing-score moves. Each changed ASIN also carries product identity (brand, title, price or price range) and fulfillment (FBA/FBM/AMZ with amz/fba share). Use when the user asks 'what changed on ', 'any updates on my watchlist', 'new sellers on the ASINs I track'. Re-run watchlist_add to reset the baseline to the current state.

ParametersJSON Schema
NameRequiredDescriptionDefault
asinNoOnly the change row for this exact ASIN.
nameYesThe list name to diff.
list_typeNoDefaults to asin.asin
max_priceNo
min_priceNo
asin_containsNo
product_brandNoExact product brand (case-insensitive).
fulfillment_inNoComma-separated FBA/FBM/AMZ to keep.
max_new_sellersNo
max_score_deltaNo
min_new_sellersNoOnly ASINs that gained at least this many new sellers.
min_score_deltaNo
max_current_scoreNo
min_current_scoreNo
max_dropped_sellersNo
min_dropped_sellersNo
product_brand_containsNo
product_title_containsNo
max_current_seller_countNo
min_current_seller_countNo
max_fulfillment_amz_dom_pctNo
max_fulfillment_fba_pen_pctNo
min_fulfillment_amz_dom_pctNo
min_fulfillment_fba_pen_pctNo
watchlist_list
Read-only
Inspect

List the workspace's saved tracking lists (name, type, item count, whether a baseline is set). Use when the user asks 'what am I tracking', 'show my watchlists', 'my saved lists'.

ParametersJSON Schema
NameRequiredDescriptionDefault
list_type_inNoComma-separated list types to keep (asin/brand/seller/niche).
updated_at_toNo
max_item_countNo
min_item_countNoOnly lists with at least this many items.
updated_at_fromNoYYYY-MM-DD; only lists updated on/after this.
watchlist_removeInspect

Remove items from a saved tracking list, or delete the whole list. Provide list_type + name; give items to drop just those, or omit items to delete the entire list. Use when the user says 'stop tracking ...', 'remove ... from my watchlist', 'delete my ... list'.

ParametersJSON Schema
NameRequiredDescriptionDefault
nameYes
itemsNoItems to remove; omit to delete the list.
list_typeYes
watchlist_stats
Read-only
Inspect

BULK report of key Amazon stats for the user's WHOLE watchlist in ONE call — every tracked ASIN in the workspace's sourcing watchlist for a marketplace, in a single pass. Use this report instead of looping a per-ASIN tool over the whole watchlist. Each tracked ASIN returns its composite sourcing score, distinct seller count, buy-box leader share, fulfillment (FBA/FBM/AMZ with amz/fba pct), product brand/title and price (or price range). Also returns a top-level summary across the whole watchlist (tracked total, scored count, average score, score buckets, Amazon-dominant / FBA-dominant counts, single-seller vs high-competition counts). Use when the user asks 'show stats for my whole watchlist', 'summarize my watchlist', 'which of my tracked ASINs are single-seller / Amazon-dominant / high-competition', 'score distribution of my watchlist', or any bulk watchlist overview. One call covers the entire watchlist — do NOT call a per-ASIN tool in a loop.

ParametersJSON Schema
NameRequiredDescriptionDefault
asinNoExact ASIN match.
sortNoSort order (all descending): score (composite sourcing score, default), seller_count (distinct sellers), buybox_share (buy-box leader share), amz_dominance, fba_penetration, or price.
limitNo
max_priceNo
min_priceNo
asin_containsNo
product_brandNoExact product brand (case-insensitive).
fulfillment_inNoComma-separated FBA/FBM/AMZ to keep.
marketplace_idNoMarketplace to scope to: 1 = Amazon UK, 2 = Amazon US (default), 3 = Walmart US. One marketplace per call.
max_seller_countNo
min_seller_countNoOnly ASINs with >= this many distinct sellers.
max_composite_scoreNo
min_composite_scoreNoOnly tracked ASINs with composite sourcing score >= this.
max_buybox_share_pctNo
min_buybox_share_pctNoOnly ASINs where the buy-box leader's share >= this percent.
max_amz_dominance_pctNo
min_amz_dominance_pctNoOnly ASINs with Amazon buy-box dominance >= this percent.
product_brand_containsNo
max_fba_penetration_pctNo
min_fba_penetration_pctNoOnly ASINs with FBA penetration >= this percent.
watchlist_webwide
Read-only
Inspect

Bulk web-wide (open-web / off-Amazon) price + MAP findings across your whole watchlist, in one call — reads already-collected results, does not run a live scan. Returns every tracked ASIN with its open-web source count, cheapest off-Amazon price (+ the domain), how many web sources violate MAP, how many are unauthorized sellers, the Amazon buy-box anchor price, and how much cheaper the web is vs Amazon. ASINs not yet scanned show 0 sources / never-scanned. Use for 'where is my whole watchlist cheaper off Amazon', 'web-wide MAP across everything I track', or 'which tracked products are undercut on the open web'. For a live single-product cross-retailer check use find_product_across_web instead.

ParametersJSON Schema
NameRequiredDescriptionDefault
asinNoExact ASIN match.
sortNoOrder: web_violations (most MAP breaches first), cheapest_web_price, web_savings_vs_amazon (biggest off-Amazon discount first), last_scan.
limitNo
asin_containsNo
product_brandNoExact product brand (case-insensitive).
marketplace_idNoMarketplace to scope the watchlist to: 1 = Amazon UK, 2 = Amazon US (default), 3 = Walmart US.
domain_containsNoSubstring match on the cheapest-source domain.
violations_onlyNoKeep only ASINs with one or more web MAP violations.
unauthorized_onlyNoKeep only ASINs with one or more unauthorized web sellers.
max_web_source_countNo
min_web_source_countNoOnly ASINs with at least this many distinct open-web sources.
max_cheapest_web_priceNo
min_cheapest_web_priceNo
product_brand_containsNo
max_web_violation_countNo
min_web_violation_countNoOnly ASINs with at least this many MAP-violating web sources.
webotee_job_status
Read-only
Inspect

Check the status of a live Amazon refresh kicked off for an ASIN (returns its current snapshot when ready). job_id is the ASIN. Use after a tool says a live refresh is collecting.

ParametersJSON Schema
NameRequiredDescriptionDefault
job_idYesThe job id (the ASIN being refreshed).
marketplace_idNoMarketplace (2 = Amazon US). Default 2.
xmkt_pricing_compare
Read-only
Inspect

Cross-marketplace (Amazon vs Walmart) pricing comparison. Returns matched pairs from mv_product_identity with current Amazon price, current Walmart price, delta %, and a coarse Amazon-FBA profitability check. Each pair also carries the Amazon ASIN's product brand, title and catalog price (or price range) plus fulfillment (FBA/FBM/Amazon). Use for arbitrage / sourcing questions ('cheaper on Walmart?'). Single-ASIN or by-brand.

ParametersJSON Schema
NameRequiredDescriptionDefault
asinNo
brandNo
fulfillment_inNoComma-separated FBA/FBM/AMZ to keep.
marketplace_idNoAmazon-side marketplace for the comparison (Walmart US is always the other side). 1 = Amazon UK, 2 = Amazon US (default)
max_amazon_priceNo
min_amazon_priceNo
max_walmart_priceNo
min_walmart_priceNo
max_match_confidenceNo
min_match_confidenceNoOnly matched pairs with Amazon<->Walmart match confidence >= this.
product_title_containsNo
max_delta_pct_amz_vs_wmtNo
max_est_arbitrage_profitNo
min_delta_pct_amz_vs_wmtNoOnly pairs whose Amazon-vs-Walmart price delta percentage is >= this.
min_est_arbitrage_profitNo

Discussions

No comments yet. Be the first to start the discussion!

Try in Browser

Your Connectors

Sign in to create a connector for this server.