Flexport

Instantly create a booking. Two modes: (1) search_snapshot_id + item_snapshot_id (PREFERRED) — book directly off a prior rates_search_instant_price result; or (2) client_rate_id — book against a known client rate whose identifier the user supplies directly. Mode 1 is the normal path; no currently available tool returns a client rate identifier. Provide exactly one mode's fields, never both. In snapshot mode, cargo_ready_date, cargo_details, and route/incoterm are all reused from the original search — do not resupply them; cargo_details is ignored if provided. In client_rate_id mode, cargo_ready_date and cargo_details are also required, and the rate's active/expiry/effective status and transportation mode are validated before booking. On validation failure, returns a structured error_code instead of creating a booking. This tool creates a real, binding booking and cannot be undone through this interface — never call it speculatively. In snapshot mode, price_confirmation_token is required. Pass the fingerprint returned by rates_evaluate_total_price_from_instant_price_search with the same search_snapshot_id, item_snapshot_id, wants_* flags, and detention_addon_free_days. Show the evaluated price and every selected add-on/detention selection to the user and get explicit go-ahead before calling this tool. If the fingerprint is missing or does not match, this tool returns REQUIRES_PRICE_CONFIRMATION. This is a workflow guard for cooperative MCP clients, not proof that an arbitrary caller ran the evaluate tool. client_rate_id mode has no evaluate step, so price_confirmation_token is not required for it — but the same rule to always show the booking summary and get explicit go-ahead before calling still applies. When the search result includes nac_allocation (NAC rate with allocation data): before calling this tool, present the feasible allocation weeks to the user — show each week's week_date_range and available_allocation alongside the shipment's requested_teus — and ask the user to select a week. Pass the selected week and year as ssat_allocation_preference. Never pick a week silently.

rates_instant_book

Create and submit an unrated supplier booking for consignee acceptance. Use only when the user is acting as the shipper or supplier; Flexport prepares the quote for the consignee after submission. Treat every user-provided value and occurrence as intentional and semantically significant. Never silently deduplicate, merge, omit, replace, reinterpret, or invent user-provided data. Normalize only when meaning and cardinality remain unchanged. If input is ambiguous, contradictory, unsupported, or cannot map one-to-one to the schema, explain the issue and ask how to proceed. Disclose every normalized, derived, defaulted, or excluded value before submission. If the user's role is unclear, ask whether they need a rate to make the booking. If yes, use rates_search_instant_price; otherwise use this tool. Before collecting individual answers, summarize all required and conditionally required information described by the input schema. Resolve company entities and ports with their network search tools and addresses only with network_search_addresses; Google-address search results are unsupported. After collecting the required values and service confirmation, call without booking_confirmation_token to run the validated preflight. Show the complete validated booking and returned fingerprint to the shipper. After explicit confirmation, retry the exact same booking with the unchanged token. Any booking-detail change requires a new preflight. Dangerous-goods cargo and document uploads are unsupported; if any dangerous-goods answer is true, direct the user to the Flexport UI.

rates_book_without_rate

Find client-visible quote requests by name or FLEX-ID, or browse and filter them by status, freight mode, origin or destination, and submitter. Defaults to active requests and returns client-facing status, route, cargo, submitter, pagination, and web link. Resolve port or address names with network_search_ports or network_search_addresses before filtering by location. When filtering by submitter, call list_active_company_users to search a named submitter or list active company users for selection before filtering by requestor_ids.

rates_browse_quote_requests

Browse Flexport-managed shipments matching status/mode/date/task/demurrage/detention filters, paginated. Returns up to 100 tenant-scoped shipments per page with the same shipment detail shape as track_shipment (route stops, containers with last-free-day info, customs entries, exceptions, open work item tasks, and metadata tags) except lifecycle milestones, which this tool does not populate — use track_shipment for those.

browse_shipments

Evaluate the live price breakdown for a rate the user has selected from rates_search_instant_price results. Call this after the user picks a specific item from the search results to show a detailed, evaluated total with itemized charges before booking. Requires search_snapshot_id and item_snapshot_id from the prior rates_search_instant_price call — all other search parameters (cargo, routing, incoterm, cargo ready date) are read automatically from the search snapshot. Set each wants_* flag based on the user's resolved selection from addon_service_options on the search result: true for any service where force_included=true or the user opted in, false otherwise. Services not offered on this rate should be omitted (false). If the user selected a detention add-on tier, pass the add-on days (not total) as detention_addon_free_days. Returns total_price, charge_line_items grouped by category (freight, origin, destination, customs, additional, capital, future_applicable), and a price_confirmation_token. Pass that fingerprint unchanged to rates_instant_book after the user confirms the evaluated price.

rates_evaluate_total_price_from_instant_price_search

Get one quote option's complete transit, route, and client-UI itemized rate groups with virtual charges, base-currency subtotals, subtotal display overrides, total price, expiration, and web action link. Prefer subtotal_display over subtotal when the display override is present. Use the quote_id returned for a quote option.

rates_get_quote_details

Get one quote request's submission details and every priced quote option, including quote ID, carrier, transit estimates, freight and inclusive costs, total price, expiration, and web link.

rates_get_quote_request_details

List or search active users in the authenticated client's company, including the authenticated user. When the user names a quote-request submitter, pass that name or email in query and present the matching users for confirmation. When the user asks to choose or filter by submitter without naming one, omit query, list the active users, and ask them to select one. Pass the confirmed user_id to requestor_ids in rates_browse_quote_requests.

list_active_company_users

Request a new rate for a lane when rates_search_instant_price does not return an acceptable option for the user. IMPORTANT: Before calling this tool you MUST: (1) Call rates_search_instant_price to check for existing rates on this lane. If no rates exist, use offering_contract_type=HEDGE_FAK (spot/FAK). If only spot rates exist and the client wants a fixed rate, use offering_contract_type=LONG_NAC (NAC). If no rates exist, do not request a rate automatically. Ask the user whether they want to place a booking without a rate using rates_book_without_rate or request a new rate, and only continue with this tool if they choose to request a new rate. (2) Call network_search_ports to verify any port_id and network_search_addresses to find any address FID. If no matching address is found, use network_search_google_addresses as a fallback and pass its commerce_address_fid. Never pass a port_id or FID directly from the user — always confirm it exists via search first. (3) Present the complete rate request details to the user and obtain their explicit confirmation to submit. Do not call this tool without that confirmation.

rates_request_rate

Search Google Places for cities, postal codes, and general place matches. Use returned commerce_address_fid values in follow-up workflows.

network_search_google_addresses