Advise where to list an item
advise_marketplacesAnswer "where should I sell this?" for one item. For each US marketplace: whether it accepts the item under its published policies (prohibited and restricted items, condition rules, approval-only categories), the fees and profit at the expected price, the lowest price that meets an optional profit goal, and when the seller gets paid. Every rule cites the official page. Returns picks (highest profit, best margin, fastest payout), ranked marketplaces, ones needing approval, and excluded ones with reasons. If a marketplace's policy doesn't clearly cover the item, it's marked unclear and excluded (treated as not permitted); tell the user to check the linked policy. Doesn't model demand or the price buyers will pay.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"item_type": "<item_type>",
"condition": "<condition>"
},
"name": "advise_marketplaces"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| goal | No | Optional: exactly one of profit (USD), margin_percent or roi_percent. | |
| detail | No | summary (default) returns totals and fee lines; full returns the complete REST response. | summary |
| package | No | Packaged unit dimensions (inches) and unit weight (pounds), used to determine the fulfillment size tier, dimensional weight (L x W x H / 139) and shipping weight. Required for amazon_fba and walmart_wfs. | |
| sort_by | No | profit | |
| condition | Yes | ||
| item_cost | No | Seller's cost of the item, in USD. Default 0. | |
| item_type | Yes | clothing (Tops, dresses, jeans, jackets, activewear); kids_clothing (Children's and infant apparel); shoes (Boots, heels, sandals, dress shoes); sneakers (Athletic and lifestyle sneakers); handbags (Handbags, totes, backpacks, designer bags); accessories (Belts, wallets, hats, scarves, sunglasses); jewelry (Fine and fashion jewelry); watches (Analog and digital wristwatches (smartwatches count as electronics)); beauty_cosmetics (Makeup, skincare, hair care); fragrance (Perfume, cologne); vitamins_supplements (Vitamins, protein powder, dietary supplements); electronics (Phones, tablets, laptops, headphones, cameras, smartwatches, consoles); video_games_media (Video games, DVDs, Blu-rays, CDs, vinyl); books (Books, textbooks, comics); toys (Toys, board games, LEGO, dolls); trading_cards (Sports and trading card game cards, graded cards); home_decor (Decor, kitchenware, bedding, lamps); furniture (Chairs, tables, dressers, shelving); sporting_goods (Fitness, outdoor, camping, team sports equipment); art (Paintings, prints, sculpture, photography) | |
| overrides | No | Per-marketplace category, options or shipping values, e.g. {"ebay": {"options": {"store_subscription": "basic"}}, "etsy": {"options": {"offsite_ads_percent": 15}}}. Categories: amazon_fbm: default, 3d_printers, amazon_device_accessories, appliances_compact, appliances_full_size, automotive, baby, backpacks_handbags_luggage, base_equipment_power_tools, beauty, industrial, clothing_accessories, computers, consumer_electronics, electronics_accessories, eyewear, footwear, furniture, gift_cards, grocery, home_kitchen, jewelry, lawn_garden, lawn_mowers_snow_throwers, mattresses, media, merchant_fulfilled_services, musical_instruments_av, office_products, pet_supplies, pet_veterinary_diets, sports_outdoors, tires, tools_home_improvement, toys_games, video_games_accessories, video_game_consoles, watches | amazon_fba: default, 3d_printers, amazon_device_accessories, appliances_compact, appliances_full_size, automotive, baby, backpacks_handbags_luggage, base_equipment_power_tools, beauty, industrial, clothing_accessories, computers, consumer_electronics, electronics_accessories, eyewear, footwear, furniture, gift_cards, grocery, home_kitchen, jewelry, lawn_garden, lawn_mowers_snow_throwers, mattresses, media, merchant_fulfilled_services, musical_instruments_av, office_products, pet_supplies, pet_veterinary_diets, sports_outdoors, tires, tools_home_improvement, toys_games, video_games_accessories, video_game_consoles, watches | walmart: default, apparel, appliances_compact, appliances_major, automotive, baby, base_power_tools, beauty, books, camera_photo, collectibles, consumer_electronics, electronics_accessories, furniture, grocery, home_kitchen_decor_garden, industrial_scientific, jewelry_precious_metals, luggage_travel, music, musical_instruments, office_products, printer_cartridges, outdoor_power_tools, outdoors_sports, outdoor_optics, personal_computers, pet_supplies, plumbing_hvac, shoes_handbags_backpacks_sunglasses, software_video_games, tires_wheels, tools_home_improvement, toys_games, video_dvd, video_game_consoles, watches | walmart_wfs: default, apparel, appliances_compact, appliances_major, automotive, baby, base_power_tools, beauty, books, camera_photo, collectibles, consumer_electronics, electronics_accessories, furniture, grocery, home_kitchen_decor_garden, industrial_scientific, jewelry_precious_metals, luggage_travel, music, musical_instruments, office_products, printer_cartridges, outdoor_power_tools, outdoors_sports, outdoor_optics, personal_computers, pet_supplies, plumbing_hvac, shoes_handbags_backpacks_sunglasses, software_video_games, tires_wheels, tools_home_improvement, toys_games, video_dvd, video_game_consoles, watches | ebay: default, electronics, clothing, books_media, vinyl_records, guitars, jewelry, watches, handbags, athletic_shoes | tiktok_shop: default, jewelry_precious, jewelry_other, collectibles, pre_owned | etsy: default | facebook_marketplace: default | poshmark: default | mercari: default | depop: default | stockx: default | |
| attributes | No | Facts that change eligibility. Etsy only accepts handmade, seller-designed, vintage (20+ years) or craft supplies. | |
| other_costs | No | Other per-item costs (packaging, ads, etc.), in USD. Default 0. | |
| marketplaces | No | Limit to these marketplaces. Default: all. amazon_fba and walmart_wfs are skipped unless package is given. | |
| shipping_cost | No | Seller's shipping label cost, in USD. Default 0. | |
| expected_price | No | Expected sale price in USD. Give this, expected_prices or goal. | |
| expected_prices | No | Per-marketplace expected prices, e.g. {"stockx": 140}. | |
| fulfillment_date | No | amazon_fba only: ship date (YYYY-MM-DD) that selects the FBA rate card. Defaults to today (UTC). Range 2026-01-15 to 2027-10-14. | |
| shipping_charged | No | Shipping the buyer pays, in USD. Default 0. | |
| estimated_sales_tax | No | Sales tax collected from the buyer, in USD (some marketplaces charge fees on it). Default 0. |