
Global Customs & Tariff Engineering Optimizer
Classifies a product under the HTS with GRI reasoning and verifies the code and general (MFN) rate against the live USITC schedule, flags when a specific sibling subheading may outrank the chosen residual one, separates lower-duty options from reclassification risk with dollar exposure, lists lawful physical tariff-engineering changes, and drafts an accurate commercial invoice description. Leads with a decision, the dollars at stake and the next step. Section 301/232/IEEPA add-ons are model estimates and marked unverified. Not legal advice or a binding ruling.
What you get
A few points of duty on a container is thousands of dollars per shipment, and a wrong code is a penalty risk under 19 U.S.C. 1592; a broker classification review typically costs $100-$300 per product. This returns a verified-rate second opinion with the exposure in dollars.
Call it
Send the JSON body below to https://agents.writerslogic.com/api/v1/optimize-tariff. An unpaid request answers 402 with the price and how to pay; a request that fails with a 5xx status is not charged.
curl -i -X POST https://agents.writerslogic.com/api/v1/optimize-tariff \
-H 'content-type: application/json' \
-d '{"productName":"Women'\''s waterproof ankle boot","materialsBreakdown":[{"material":"Rubber/plastics outer sole","percentByWeight":45},{"material":"Polyurethane-coated textile upper","percentByWeight":40},{"material":"Textile lining","percentByWeight":15}],"intendedUse":"Everyday wet-weather footwear","originCountry":"Vietnam","destinationCountry":"United States","customsValueUsd":85000,"importStateOfAssembly":"fully_assembled"}'
Input
| Field | Type | Required | Description |
|---|---|---|---|
productName | string; length 2..300 | yes | |
materialsBreakdown | array<object>; max 30 items | yes | |
intendedUse | string; length 2..2000 | yes | |
originCountry | string; length 2..60 | yes | |
destinationCountry | string; length 2..60 | yes | |
productDescription | string; length 0..5000 | no | Construction, dimensions, how it works, packaging. |
customsValueUsd | number; 0..10000000000 | no | Entered value, used to estimate duty and savings. |
currentHtsCode | string | no | |
importStateOfAssembly | string; one of "fully_assembled", "unassembled_kit", "components", "bulk" | no | |
productUrl | string; length 0..2048 | no | Public product or spec-sheet page. Its text is read to supplement productDescription; if it cannot be read the request still succeeds and says so in warnings. |
Example request body
{
"productName": "Women's waterproof ankle boot",
"materialsBreakdown": [
{
"material": "Rubber/plastics outer sole",
"percentByWeight": 45
},
{
"material": "Polyurethane-coated textile upper",
"percentByWeight": 40
},
{
"material": "Textile lining",
"percentByWeight": 15
}
],
"intendedUse": "Everyday wet-weather footwear",
"originCountry": "Vietnam",
"destinationCountry": "United States",
"customsValueUsd": 85000,
"importStateOfAssembly": "fully_assembled"
}
Result
The response is { "data": ..., "_provenance": ... }. data carries these fields; _provenance is a signed W3C Verifiable Credential with a C2PA-style manifest, checked free at POST /api/v1/verify-provenance.
| Field | Type | Required | Description |
|---|---|---|---|
primaryClassification | object | no | |
additionalDuties | array<object> | no | |
alternatives | array<object> | no | |
engineeringOptions | array<object> | no | |
commercialInvoiceDescription | string | no | Accurate description of the goods as actually imported. |
documentation | array<string> | no | |
complianceWarnings | array<string> | no | |
bindingRulingAdvice | string | no | |
headline | object | no | Decision first: the verdict, the dollars at stake, confidence and the exact next step. |
lowerDutyOptions | array<object> | no | Alternatives and engineering options whose MFN rate is lower than the primary, best saving first. |
reclassificationRisk | object | no | present is true when a strong or moderate alternative carries a higher MFN rate than the primary; exposureUsd is the extra duty on customsValueUsd. |
classificationChecks | array<object> | no | Code-level checks against the official schedule, e.g. a specific sibling subheading matching your description of the goods. |
fees | array<object> | no | Merchandise processing and harbor maintenance fees, computed in code and kept out of the duty rate. |
warnings | array<string> | no | |
disclaimer | string | no | |
currentHtsCodeCheck | object | no | |
estimate | object | no |
Pay and connect
Available through: x402 (USDC on Base), MCP, RapidAPI, Apify.
Machine-readable
- This agent as JSON (schemas, example, OpenAPI operation)
- Free signed sample response
- OpenAPI 3.1 · Catalog · Index of every agent