Shipments, Stops & Carrier Assignments
This page covers tools in the Shipments, Stops, and Carrier Assignments domains.
Shipment Tools
| Tool | Description | Use Case | Access |
|---|---|---|---|
list_shipments |
List shipments with filters | "Show me all FTL shipments picked up in Texas this week" | Read |
get_shipment |
Get a single shipment by ID | Look up the full details of a specific shipment before taking action | Read |
get_shipment_summary |
Full snapshot — shipment + stops + carrier + tracking in one call | Get everything you need about a shipment without chaining multiple calls | Read |
create_shipment |
Create a new shipment | Programmatically create a shipment from an order or external trigger | Write |
update_shipment |
Update shipment fields | Correct a pickup date, reference number, or freight details on an existing shipment | Write |
search_shipment_dashboard |
Search the shipment dashboard | "Find any shipments with BOL number 12345" | Read |
bulk_action_shipments |
Apply a bulk action to multiple shipments | Archive or update status across a batch of shipments at once | Write |
download_shipments_csv |
Download shipment data as CSV | "Pull a CSV export of all delivered shipments from last month" | Read |
get_shipment_state_info |
Get valid next actions for a shipment's current status | Check what operations are allowed before the agent attempts a write | Read |
Stop Tools
| Tool | Description | Use Case | Access |
|---|---|---|---|
list_stops |
List all stops for a shipment | Review pickup and delivery locations on a multi-stop shipment | Read |
get_stop |
Get a single stop by ID | Retrieve the scheduled arrival window and address for a specific stop | Read |
update_stop |
Update stop fields | Adjust a delivery appointment time or correct an address on a stop | Write |
Carrier Assignment Tools
| Tool | Description | Use Case | Access |
|---|---|---|---|
get_carrier_assignment |
Get the current carrier assignment for a shipment | "Who is the assigned carrier for shipment SHP-99999?" | Read |
create_carrier_assignment |
Assign a carrier to a shipment | Tender a shipment to a carrier after rate shopping | Write |
update_carrier_assignment |
Update an existing carrier assignment | Change the carrier or update pro number after initial assignment | Write |
remove_carrier_assignment |
Remove the carrier assignment from a shipment | Unassign a carrier to re-tender a shipment to a different provider | Write |