Total landed cost: item + fee + shipping + customs duties & import taxes
estimate_landed_costEstimates what a buyer pays in total to get US goods delivered: item price, optional US sales tax, GS Assisted Purchase fee, live GS shipping (if package weight given) and estimated import duty/VAT for the destination from a sourced rules table (Angola, Saudi Arabia, UAE, UK, Canada, Australia, Nigeria, Pakistan, India, Brazil, Germany, France, Netherlands). Returns a low–high range. Use for 'how much will it cost in total to buy X in the US and get it to ', 'customs duty / VAT / import tax on a US order'. Results are ESTIMATES, not quotes.
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": {
"destination_country": "<destination_country>",
"items_total_usd": "<items_total_usd>"
},
"name": "estimate_landed_cost"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| hs_code | No | Optional HS code; used with Easyship's duty API when configured. | |
| package | No | Package for a live shipping quote. | |
| shipping_usd | No | Known shipping cost. Omit and pass package to fetch live GS rates. | |
| payment_method | No | How the GS invoice will be paid. Bank transfer or crypto: 0% standard assisted-purchase fee. | card |
| item_categories | No | Distinct product types (EU €3-per-category duty). Default 1. | |
| items_total_usd | Yes | Total price of the items in USD (all quantities). | |
| us_sales_tax_pct | No | US sales tax % if the store charges it. Default 0 (GS address is in Delaware: no sales tax). | |
| assisted_purchase | No | 'standard' if GS buys it for you; 'none' if the shopper buys and ships to their GS address. | standard |
| preferred_carrier | No | Pick the cheapest service of this carrier (DHL, FedEx, UPS, USPS). | |
| destination_country | Yes | ISO 2-letter code or country name. |