Integration · Shipping

Connect Claude & ChatGPT to Zonos

Ask your AI what duties and taxes a shipment to Germany will cost, which HS code a product belongs under, or where an order stands in Zonos. It can calculate landed cost and shipping rates, classify items, check restrictions, keep your catalog up to date and handle orders with notes, holds, tracking numbers, cancellations and refunds.

Connect Zonos free

Free plan, no credit card. Takes about a minute.

Try asking

“What are the duties and taxes on 3 wool sweaters shipped from the US to Germany?”
The AI calculates a landed cost quote with the duties, taxes and fees for the shipment.
“Which HS code fits a stainless steel water bottle?”
It classifies the product into an HS code and can check that the code is valid for the countries you ship to.
“Can we ship these items from Denmark to Australia?”
It checks the items against that lane and tells you whether any are restricted or prohibited.

What your AI can do

Landed cost and shipping

Calculate duties, taxes and fees, read earlier quotes, and get rates from the carriers and service levels you have set up.

Classification and compliance

Classify items into HS codes, look up and validate codes by country, and check item restrictions for a shipping lane.

Orders and catalog

Search and read orders, add notes, tracking and holds, cancel or refund, and manage catalog items with HS code and origin.

“Put order 10452 on hold and note that the address needs checking.”
It finds the order by your store order number, places it on hold and adds the note.
“Add tracking number 1Z999AA10123456784 to order 10452.”
It adds the tracking number to the order and can show which items have shipped and which have not.
“Refund the shipping on order 10388.”
It refunds the shipping subtotal on the order. The money goes back to the customer and the refund cannot be undone.

22 tools for Zonos

These tools are switched on when you connect. You can switch any of them off, or require your approval before it runs.

add_order_noteChanges dataAdd a note to an order. Pass `orderId`, `note` and `type` (e.g. COMMENT) in `input`.
add_order_tracking_numbersChanges dataAdd tracking numbers to an order. Pass the order `id` and `trackingNumbers` in `input`.
calculate_landed_costChanges dataCalculate a landed cost quote (duties, taxes and fees) for a cross-border shipment. Pass items, parties (origin and destination), `endUse` and `tariffRate` in `input`.
calculate_shipping_ratesChanges dataCalculate available shipping rates for a shipment based on your configured carriers and service levels. Pass the shipment details in `input`.
cancel_orderChanges dataCancel an order. Pass the order `id`, an optional `note` and `skipRefund` in `input`. Cancelling cannot be undone and refunds the customer unless `skipRefund` is set.
check_item_restrictionsChanges dataCheck whether items are restricted or prohibited for a shipment lane. Pass `items`, `shipFromCountry` and `shipToCountry` in `input`.
classify_itemsChanges dataClassify one or more products into HS codes. Pass each item's `name` plus optional description, material, categories and ship-to countries in `input`.
create_catalog_itemsChanges dataAdd one or more items to your Zonos catalog with SKU, name, description, amount, HS code and country of origin in `input`.
find_orders_by_order_numberChanges dataFind orders by your own store order numbers (`account_order_numbers`, up to 100).
get_catalog_itemChanges dataGet one catalog item by `id`, `sku` or `product_id`, including its HS code and country of origin.
get_classificationChanges dataGet a previous HS code classification by `id`.
get_hs_codeChanges dataLook up an HS code and its description for a country. Pass `code` and `countryCode` in `hs_code_input`.
get_landed_costChanges dataGet a previously calculated landed cost by `id`, with its duty, tax and fee breakdown.
get_orderChanges dataGet one order by `order_id`, with items, parties, amounts and status.
get_order_fulfillmentChanges dataShow which items of an order (`order_id`) have shipped and which have not.
get_shipmentChanges dataGet one shipment by `id`, with its cartons, labels and tracking.
get_shipment_labelsChanges dataGet a download link for all labels of a shipment (`shipment_id`) merged into one file. Set `include_packing_slips` to add packing slips.
refund_orderMoves moneyRefund money on an order. Pass the order `id`, `currencyCode` and the `subtotals` to refund (e.g. ITEM, SHIPPING, DUTY_TAX_FEE) in `input`. This returns real money to the customer and cannot be undone.
search_ordersChanges dataSearch orders with filters such as free text `q`, `status`, created date or total amount in `filter`. Paginate with `first` and `after`.
set_order_holdChanges dataPlace an order on hold or release its hold. Pass the order `id`, `hold` (true or false) and an optional `note` in `input`.
update_catalog_itemsChanges dataUpdate one or more catalog items in `input`. Only the fields you pass change.
validate_hs_codesChanges dataCheck whether HS codes are valid for a list of countries. Pass `hsCode` and `countries` for each entry in `input`.

Set up in three steps

1
Pick the app
Create a free PipMCP account and choose Zonos from the app list.
2
Paste your key
Paste your Zonos API credential token. In the Zonos Dashboard go to Settings > Integrations and copy the token under App Credentials. PipMCP sends it in the credentialToken header.
3
Add the link to your AI
You get a personal MCP link. Add it to Claude, ChatGPT or Cursor:
1. Click your name, then Settings › Connectors › Add custom connector.
2. Paste your link as the Remote MCP server URL.
3. Switch it on from the + menu in a chat.

Questions

What can the AI do in Zonos?

It can calculate landed cost and shipping rates, classify items into HS codes, look up and validate HS codes, and check item restrictions. It can search and read orders, shipments and catalog items, add catalog items, add order notes and tracking numbers, put orders on hold, and cancel or refund orders.

Does the AI see my Zonos credentials?

No. Your Zonos credentials are encrypted at rest and never shown to the AI. After you save them, they are not shown again, not even to you. The AI only sees the results of the tools it calls.

Can I control what the AI is allowed to do?

Yes. You choose which tools are switched on, so you can start with quotes and lookups only. Cancelling an order refunds the customer unless you skip the refund, and refund_order returns real money. Neither can be undone, and both can require your approval before they run. Every tool call is logged.

Does it work with ChatGPT?

Yes. In ChatGPT go to Settings › Apps & Connectors › Advanced and turn on Developer mode, then add your PipMCP link. Developer mode needs a paid ChatGPT plan: Plus, Pro, Business or Enterprise. The same link also works in Claude (Settings › Connectors › Add custom connector), Cursor and other MCP clients.

What does it cost?

PipMCP has a free plan with no credit card required. Paid plans bill per completed task. You also need your own Zonos account.

Can the AI get shipping labels and rates?

Yes. get_shipment_labels returns a download link with all labels of a shipment merged into one file, with packing slips if you want them. calculate_shipping_rates returns the rates available from the carriers and service levels you have configured in Zonos.