# Kargo MCP MCP > Kargo connects your AI agent directly to your logistics platform. You can track real-time shipments, check facility device health, manage customer orders, and sync payload data—all without opening a browser dashboard. ## Overview - **Category:** erp-operations - **Price:** Free - **Tags:** loading-dock-automation, shipment-tracking, inventory-visibility, logistics-management, supply-chain-optimization ## Description Managing a loading dock means juggling dozens of dashboards: one for inventory, another for carrier contact info, and yet a third just for IoT sensor status. Kargo lets you consolidate that mess into a single conversation with your agent. Need to know if a shipment is ready to load? Ask. The system pulls the current status instantly, even giving you the specific carrier details. You can check every facility's device health or pull up all customer orders scheduled for today. If an order changes, you send that updated data payload directly back into Kargo’s unified endpoint, keeping your entire operation synced in real time. By connecting this MCP through Vinkius, you get full visibility into everything running on site—from the smallest sensor to the biggest shipment manifest. It’s all accessible through natural language conversation. ## Tools ### get_carrier_info Retrieves contact information for a specific shipping carrier. ### get_device_status Checks the current operational status of an individual IoT device at a facility. ### get_order Pulls detailed information for a single customer order number. ### get_shipment Retrieves complete data details for a specific shipment ID. ### list_devices Provides an inventory list of all connected IoT devices at the facility. ### list_facilities Lists every business location associated with your account. ### list_orders Gives a list of all customer orders managed by the facility. ### list_payload_logs Reviews the history and records of data payloads synced to the platform. ### list_shipments Generates a list of all current and past shipments at the facility. ### update_logistics Pushes updated order or shipment data to Kargo's main unified endpoint. ## Prompt Examples **Prompt:** ``` List all active shipments for my facility. ``` **Response:** ``` I've retrieved the current shipments. You have 4 active shipments: 'SHP-1001' (Carrier: Swift Logistics, Status: At Dock) and 3 others scheduled for later today. Would you like the details for SHP-1001? ``` **Prompt:** ``` Check the status of all IoT devices in the facility. ``` **Response:** ``` I've checked your IoT fleet. You have 12 devices registered: 10 are 'online' and functioning correctly, while 2 (ID: CAM-04 and ID: SNSR-09) are currently 'offline'. Shall I retrieve the last-seen data for the offline devices? ``` **Prompt:** ``` Get details for shipment number SHP-2024-05. ``` **Response:** ``` Inspecting SHP-2024-05... This shipment is handled by 'Global Freight' and is scheduled to depart at 4:30 PM. It contains 2 orders: #ORD-99 (Customer: Acme Corp) and #ORD-102 (Customer: RetailPlus). ``` ## Capabilities ### Track Shipment Status Get real-time status updates and carrier contact information for any specific or bulk shipment. ### View Facility Assets List all connected business locations and check the live operational status of every IoT device, like cameras and sensors. ### Manage Orders and Inventory Access facility-wide customer order lists and retrieve full metadata for specific orders or shipments using their IDs. ### Synchronize Operational Data Push updated order and shipment data directly to the platform's unified endpoint, ensuring all your systems stay synced. ### Audit System Activity Review historical logs of all data payloads pushed to the system for compliance or troubleshooting. ## Use Cases ### The Morning Dispatch Check A coordinator needs to confirm if three specific shipments are ready for departure. They ask their agent to use `list_shipments` and then specify the IDs. The agent compiles a report, confirming they're all at the dock and listing the associated carrier contact info via `get_carrier_info`. No dashboard hopping needed. ### The Inventory Reconciliation An analyst needs to verify that the physical inventory matches the digital record. They run a check using `list_orders` for today's facility orders, then use `get_order` on the top three records to cross-reference customer details against shipment manifest data. ### The System Sync Failure IT notices an order status hasn't updated in 24 hours. Instead of manually troubleshooting, they use `list_payload_logs` to check the synchronization history and then run `update_logistics`, forcing a fresh data push. ### The Asset Health Check A manager needs an immediate status report on all assets. They ask about device health, running a query that uses `list_facilities` to scope the location and then runs `get_device_status` for any flagged sensors. ## Benefits - Instantly know where everything is. Instead of opening a separate dashboard to check carrier contact details, you simply ask for it using `get_carrier_info` and get the number immediately. - Keep tabs on physical hardware effortlessly. Use `list_devices` or `get_device_status` to monitor if sensors are online, catching potential failures before they stop operations. - Cut down on manual data entry and errors. When an order changes, you don't copy-paste; you just tell your agent to run `update_logistics`, syncing the data automatically. - Get full context on shipments fast. You can pull up a specific manifest using `get_shipment` or check all active freight with `list_shipments`—all in one conversational step. - Maintain compliance and visibility. Running through `list_payload_logs` means you have an instant, searchable record of every data sync that ever happened. ## How It Works The bottom line is, you talk to your agent about logistics problems instead of clicking through multiple dashboards and forms. 1. Subscribe to this MCP and provide your Kargo API Token, Business Slug, and Facility Slug. 2. Your agent accesses the necessary permissions within the Vinkius catalog. You confirm the connection parameters in your client app. 3. You ask your AI agent a question—like 'What's the status of devices at the West Coast facility?'—and it executes the required tool calls to give you an answer. ## Frequently Asked Questions **How do I use list_shipments with Kargo?** You ask your agent to 'list all shipments for today.' The MCP runs `list_shipments` and gives you a comprehensive, up-to-date roster of everything at the facility. **Can I check device status with get_device_status?** Yes. You ask your agent to 'check the sensor status for CAM-04.' It executes `get_device_status` and reports back if it's online, offline, or reporting an error. **What is list_payload_logs?** This tool lets you review the history of data payloads. If something went wrong with a sync, checking `list_payload_logs` tells you exactly when and what was pushed to the platform. **Does get_order use list_orders?** Not directly. You use `list_orders` to see all orders at a facility, but then you use `get_order` with a specific ID to pull the full details for just that one record. **How do I use `list_facilities` to see all my business locations?** It returns a list of every facility registered in your Kargo account. You must grab the correct Facility Slug from this output before calling other tools, like `get_order`, for specific site data. **What comprehensive details does the `get_shipment` tool provide?** This tool pulls everything about a single shipment. You get carrier contact info, scheduled departure times, and all associated orders linked to that ID in one call. **If `update_logistics` fails, how do I troubleshoot the data sync issue?** The tool returns an error message specifying why the payload failed. Cross-reference this failure reason with the history of successful pushes using `list_payload_logs`. **What kind of status information does `list_devices` report on my IoT fleet?** This function gives a real-time snapshot of all devices. It reports whether each device is online or offline and includes the last data timestamp recorded for that unit. **Where do I find my Business and Facility Slugs?** These unique identifiers are assigned to your organization by Kargo. You can find them in your dashboard settings or by contacting your Kargo account manager. **Can I check the status of physical devices in the warehouse?** Yes! Use the `list_devices` tool to see all IoT equipment at your facility, and `get_device_status` for detailed health metrics and last-seen timestamps for a specific unit. **What is the Unified Endpoint used for?** The Unified Endpoint allows you to push external order or shipment data into the Kargo system for automated processing and real-time visibility updates.