In the Zonos Dashboard, navigate to Settings > Integrations, create a GraphQL API key, and assign the Classify and Landed Cost roles to the key.
Send a GraphQL POST request to https://api.zonos.com/graphql with the header credentialToken: YOUR_TOKEN and Content-Type: application/json.
Call the classify mutation passing item name, description, material, and countryOfOrigin; Zonos returns an HS code with a confidence score — store both for audit purposes.
Pass the returned HS code, declared value, origin country, and destination country into the landedCost query to retrieve itemized duties, import taxes, and carrier fees.
Present the itemized landed cost breakdown at checkout; Zonos Guaranteed Landed Cost mode shifts duty liability to Zonos, while estimated mode keeps liability with the merchant.
Handle the 10,000 free classifications per year cap; beyond that limit, per-classification fees apply — cache classification results by item SKU to minimise API calls.
Known gotchas
Zonos uses a GraphQL API, not REST, for its primary integration path; the REST Classify endpoint exists but is a secondary option — use GraphQL for full feature parity including the landedCost query.
HS codes returned by Classify are best-effort AI classifications; for high-value, regulated, or restricted goods, validate against the official tariff schedule or obtain a binding ruling before relying on the API result.
The credentialToken header name is specific to Zonos and differs from the standard Authorization: Bearer pattern; using the wrong header name will return a 401 with no further detail.
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp