Skip to main content
Glama

ListMath: Marketplace Seller Fees

Advise where to list an item

advise_marketplaces
Read-onlyIdempotent

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

NameRequiredDescriptionDefault
goalNoOptional: exactly one of profit (USD), margin_percent or roi_percent.
detailNosummary (default) returns totals and fee lines; full returns the complete REST response.summary
packageNoPackaged 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_byNoprofit
conditionYes
item_costNoSeller's cost of the item, in USD. Default 0.
item_typeYesclothing (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)
overridesNoPer-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
attributesNoFacts that change eligibility. Etsy only accepts handmade, seller-designed, vintage (20+ years) or craft supplies.
other_costsNoOther per-item costs (packaging, ads, etc.), in USD. Default 0.
marketplacesNoLimit to these marketplaces. Default: all. amazon_fba and walmart_wfs are skipped unless package is given.
shipping_costNoSeller's shipping label cost, in USD. Default 0.
expected_priceNoExpected sale price in USD. Give this, expected_prices or goal.
expected_pricesNoPer-marketplace expected prices, e.g. {"stockx": 140}.
fulfillment_dateNoamazon_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_chargedNoShipping the buyer pays, in USD. Default 0.
estimated_sales_taxNoSales tax collected from the buyer, in USD (some marketplaces charge fees on it). Default 0.

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A4/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already establish read-only, idempotent, non-destructive, closed-world behavior, and the description adds genuinely non-obvious traits: every rule cites the official policy page, ambiguous coverage is conservatively treated as not permitted, and the agent is told to surface the linked policy to the user. It doesn't discuss result volume, latency, or failure modes, but that is minor against strong annotation coverage.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Front-loaded with the question it answers, then results, then output shape, then edge-case handling, then a closing scope caveat. Every sentence carries information — no filler, no restatement of the title.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With 17 parameters, nested option objects, and no output schema, the description carries the burden of describing returns — and it does enumerate picks, ranked marketplaces, approval-needed, and excluded-with-reasons. The main residual gap is how overrides and eligibility attributes change outcomes, plus any ordering semantics beyond the stated ranking criteria.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 88%, so the baseline is 3. The description reinforces the expected-price and optional-profit-goal inputs and the package-gating of FBA/WFS, but adds nothing about overrides, attributes, detail, sort_by, or the per-marketplace price map — all of which remain documented only in the schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

Opens with a concrete user question ("where should I sell this?") and pins the scope to "one item", then enumerates what it produces per marketplace (eligibility, fees/profit, target price, payout timing). The verb+resource is unambiguous. It stops short of 5 because it never distinguishes itself from the sibling compare_marketplaces or calculate_fees, which an agent must choose between.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Clear context for when the tool applies and explicit boundaries: it needs a price or profit goal, amazon_fba/walmart_wfs require package data, and unclear policies are deliberately excluded. It also states a scope exclusion ("Doesn't model demand or the price buyers will pay"). No explicit alternative-tool routing, which is the gap to 5.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources