{"componentChunkName":"component---src-templates-simple-markdown-js","path":"/docs/mcp/use-cases/","matchPath":"","result":{"data":{"markdownRemark":{"html":"

Use Cases

\n

AI-Powered Exception Management

\n

Trigger: A shipment is flagged as delayed.

\n

The agent:

\n
    \n
  1. \nCalls \nget_shipment_summary\n — a single compound tool call that returns a full snapshot of the shipment, its stops, and its carrier assignment (replacing 5 separate API calls)\n
    2. \n
  2. \nChecks \nget_shipment_state_info\n to confirm which actions are permitted given the current status\n
    3. \n
  3. \nCreates a note via \ncreate_shipment_note\n to log the exception\n
    4. \n
  4. \nCoordinates next steps with the carrier\n
    5. \n
\n

Outcome: The issue is surfaced and actioned proactively with zero human touches required.

\n
\n

Building an Internal Logistics Agent

\n

Trigger: An ops team wants a \"logistics assistant\" in their daily tooling.

\n

Steps:

\n
    \n
  1. \nGet a Shipwell API token from \nSettings → API Management\n
    2. \n
  2. \nAdd one config block to Claude Desktop or Cursor (see \nQuickstart\n)\n
    3. \n
  3. \nThe agent auto-discovers all 90+ tools via MCP — no API docs needed, no custom integration work\n
    4. \n
\n

Outcome: A working logistics agent is live in under an hour.

\n
\n

Safe AI Automation with Dry-Run Validation

\n

Trigger: A team wants AI to execute carrier assignments autonomously but needs confidence before enabling live writes.

\n

Steps:

\n
    \n
  1. \nEnable \nSHIPWELL_MCP_DRYRUN=true\n in your MCP server config\n
    2. \n
  2. \nThe agent runs in full simulation mode\n
    3. \n
  3. \nReview the risk reports — every action is rated \nlow\n, \nmedium\n, \nhigh\n, or \ncritical\n
    4. \n
  4. \nEnable live writes when the team is satisfied with the agent's behavior\n
    5. \n
\n

Outcome: Full confidence in AI behavior before any real freight data is touched. See Safety & Write Access for more on dry-run mode.

\n
\n

Rate Shopping & Contract Lane Optimization

\n

Trigger: \"What's the best rate for this lane?\"

\n

The agent calls plan_shipment_options — a compound tool that pulls active contracts and calculates estimated charges in a single call.

\n

Outcome: Instant rate comparison across all contracts with no manual TMS navigation. See Compound Tools for details.

\n
\n

Search and Filter Shipments

\n

Trigger: An operator needs to find specific shipments across a large history without logging into the TMS.

\n

Ask your AI assistant to search using natural language:

\n\n

Outcome: Shipments found in seconds using plain language — no filters to configure, no reports to run.

\n
\n

Track Freight in Real Time

\n

Trigger: An operator needs a live status update on a shipment without digging through the TMS.

\n

Ask your AI assistant for tracking data and location history:

\n\n

Outcome: Live tracking data surfaced instantly in conversation, without navigating the TMS UI.

\n
\n

Look Up Carrier Information

\n

Trigger: A team needs carrier details — credentials, equipment types, or current assignments — quickly.

\n

Ask your AI assistant to query carrier data:

\n\n

Outcome: Carrier information retrieved on demand without searching through carrier management screens.

\n
\n

Review Invoices and Settlements

\n

Trigger: An AP or finance team needs to audit the invoice pipeline by status, carrier, or amount.

\n

Ask your AI assistant to query invoices:

\n\n

Outcome: Invoice pipeline visibility in plain language — no manual filtering or report exports required.

\n
\n

Manage Addresses and Dock Schedules

\n

Trigger: An ops team needs facility details, dock availability, or appointment information without switching tools.

\n

Ask your AI assistant to query facility and dock data:

\n\n

Outcome: Facility and scheduling information surfaced in conversation, reducing context-switching for ops teams.

","headings":[{"value":"Use Cases","depth":1},{"value":"AI-Powered Exception Management","depth":2},{"value":"Building an Internal Logistics Agent","depth":2},{"value":"Safe AI Automation with Dry-Run Validation","depth":2},{"value":"Rate Shopping & Contract Lane Optimization","depth":2},{"value":"Search and Filter Shipments","depth":2},{"value":"Track Freight in Real Time","depth":2},{"value":"Look Up Carrier Information","depth":2},{"value":"Review Invoices and Settlements","depth":2},{"value":"Manage Addresses and Dock Schedules","depth":2}]},"contentItem":{"data":{"lastModified":"2026-05-14T19:02:55.000Z","enableToc":null,"disableLastModified":null,"tocMaxDepth":null,"requestLogin":false}},"siteConfig":{"enableToc":true,"disableLastModified":false,"tocMaxDepth":4}},"pageContext":{"matchPath":"","id":"b22a3439-6199-5fa3-8438-b29f33c1a485__redocly content/docs/mcp/use-cases/","seo":{"title":"Use Cases","description":null,"image":"","keywords":null,"jsonLd":null,"lang":null,"siteUrl":null},"pageId":"docs/mcp/use-cases.md","pageBaseUrl":"/docs/mcp/use-cases","type":"markdown","toc":{"enable":true,"maxDepth":4,"headings":[{"depth":1,"value":"Use Cases","id":"use-cases"},{"depth":2,"value":"AI-Powered Exception Management","id":"ai-powered-exception-management"},{"depth":2,"value":"Building an Internal Logistics Agent","id":"building-an-internal-logistics-agent"},{"depth":2,"value":"Safe AI Automation with Dry-Run Validation","id":"safe-ai-automation-with-dry-run-validation"},{"depth":2,"value":"Rate Shopping & Contract Lane Optimization","id":"rate-shopping--contract-lane-optimization"},{"depth":2,"value":"Search and Filter Shipments","id":"search-and-filter-shipments"},{"depth":2,"value":"Track Freight in Real Time","id":"track-freight-in-real-time"},{"depth":2,"value":"Look Up Carrier Information","id":"look-up-carrier-information"},{"depth":2,"value":"Review Invoices and Settlements","id":"review-invoices-and-settlements"},{"depth":2,"value":"Manage Addresses and Dock Schedules","id":"manage-addresses-and-dock-schedules"}]},"data":{"title":""},"catalogInfo":null,"link":"/docs/mcp/use-cases/","sidebarName":"developerPortal","isLanding":false,"showPrevButton":null,"showNextButton":null,"apiVersions":null,"apiVersionId":null,"isDefaultApiVersion":null}},"staticQueryHashes":["1123603147","1302185487","1344209882","1398840060","1520077861","1975142765","2667623876","2950305614","3240152602","3743992808","561138138"]}