Skip to main content
Glama

ListMath: Marketplace Seller Fees

Compare marketplaces

compare_marketplaces
Read-onlyIdempotent

Rank every supported US marketplace (or a chosen subset) by the profit the seller keeps when selling one item at the same price. Returns the best marketplace, each marketplace's fees, payout and margin, and any marketplaces skipped or rejected with the reason.

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": {
      "sale_price": "<sale_price>"
    },
    "name": "compare_marketplaces"
  }
}

Input Schema

NameRequiredDescriptionDefault
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.
item_costNoSeller's cost of the item, in USD. Default 0.
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
sale_priceYesItem price the buyer pays, in USD, excluding shipping and tax.
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.
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

A3.7/5.0
Behavior4/5

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

Annotations already declare readOnlyHint, idempotentHint, non-destructive and closed-world, so the safety profile is covered. The description adds value beyond that by disclosing the return shape (best marketplace, fees, payout, margin) and the important behavior that unsupported or ineligible marketplaces are surfaced as skipped/rejected with reasons rather than silently dropped.

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

Conciseness4/5

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

Two sentences, front-loaded with the core ranking behavior and followed by the return contents. No filler, though the second sentence is a dense list that could be slightly tightened.

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?

For an 11-parameter tool with nested objects and no output schema, the description usefully explains what comes back and how ineligible marketplaces are handled. It omits any mention of the package requirement gating amazon_fba/walmart_wfs or the fulfillment_date rate card, but those are covered by the schema.

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 description coverage is 100%, so all 11 parameters including the nested package and overrides objects are already documented. The description only reinforces the 'same price' framing and the optional subset selection; it adds no meaning about package, fulfillment_date, or override semantics beyond the schema, so baseline 3 applies.

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?

States a specific verb (rank) plus the resource (every supported US marketplace) and the ranking criterion (profit the seller keeps at the same price). An agent can distinguish this from a simple fee calculator, though the description never names a sibling like advise_marketplaces or calculate_fees to sharpen the boundary.

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

Usage Guidelines3/5

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

Scope is implied ('every supported US marketplace (or a chosen subset)'), which tells the agent this is a cross-marketplace comparison rather than a single-fee lookup. However, there is no explicit when-to-use or when-not-to-use sentence and no named alternative for cases like a single marketplace fee query.

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