Tool reference

Every tool the AfterShip Post-purchase MCP server exposes, grouped by product. There are 21 in total — 9 that read your data and 12 that change it.

Read tools the agent can run on its own. Write tools change real records, so the agent shows you what will change and waits for your confirmation first. See how the agent handles writes for the rules it follows.

Tracking

Tool	Type	Description
list_shipments	Read	List shipments, with options to filter by tracking number, order number, carrier, status (including Exception and Expired), destination, date range, etc. Each row carries the internal id used to look up the detail.
get_shipment	Read	Get details of a shipment, including shipment status, checkpoints, delivery estimate, and related carrier and customer information.
get_field_options	Read	Look up the valid values, with display labels, for one filter dimension of one product (tracking or returns) — carriers, statuses, service types, shipping methods, countries, and so on. Returns the whole option set in a single call.
update_shipment	Write	Update editable fields on one shipment — title, note, language, custom fields, tags, customer name / email / phone, and the origin / destination address. The order number cannot be changed.
retrack_shipment	Write	Re-activate tracking for one shipment that stopped being tracked (typically an expired one). A shipment can be retracked at most 3 times.
mark_shipment_status	Write	Manually mark one shipment as reaching a final state — delivered, lost, or returned_to_sender. This overrides what the carrier reports.

Returns

Tool	Type	Description
list_returns	Read	List returns, with options to filter by return status, date range, shipping status, refund status, etc.
get_return	Read	Get details of a return, including return items, exchange items, status, return value, return reason, and related return information.
list_return_workflow	Read	List the return workflows configured for your organization, with their priority, status, and action type.
get_return_workflow	Read	Get one return workflow by id, including the trigger conditions that the list view leaves out.
list_return_allowlist	Read	List the allowlist rules that let a return through.
list_return_blocklist	Read	List the blocklist rules that stop a return from being started.
approve_return	Write	Approve one submitted RMA.
reject_return	Write	Reject one submitted RMA. The rejection reason has to come from you — the agent will not invent one.
receive_return_items	Write	Record that returned items physically arrived for one approved RMA, optionally with quality-inspection grades (a best to d worst). Restocking is not decided here.
resolve_return	Write	Close one processed RMA. Only refund outcomes are supported today — to the original payment method or as store credit, as configured upstream. Exchanges cannot be created here.
add_return_comment	Write	Post an internal note on one RMA's timeline. It is written for your team and never sent to the shopper.
add_return_allowlist	Write	Add one or more allowlist rules.
remove_return_allowlist	Write	Remove one allowlist rule by its id.
add_return_blocklist	Write	Add one or more blocklist rules.
remove_return_blocklist	Write	Remove one blocklist rule by its id.