# Flexport Logistics MCP > Flexport Logistics MCP connects your AI agent directly to global e-commerce fulfillment networks. Manage everything from placing new orders and checking real-time stock levels to tracking inbound shipments and handling returns, all through natural conversation. It gives you full visibility into the entire supply chain. ## Overview - **Category:** ecommerce - **Price:** Free - **Tags:** fulfillment-network, order-management, warehousing, returns-processing, inventory-tracking, supply-chain-visibility ## Description Running an e-commerce business means juggling dozens of moving pieces: inventory counts, customer return requests, fulfillment order creation, and shipment labels. This MCP lets your agent handle that complexity using Flexport Logistics' global network data. You can ask about current stock levels across multiple warehouses or track the status of a specific inbound delivery without logging into any portal. When you connect this through Vinkius Marketplace to any AI client, it turns complex logistics tasks into simple conversations. Your agent handles listing product details, checking inventory availability, creating fulfillment orders for customers, and gathering necessary shipment labels. It’s about getting instant, accurate answers on everything from warehouse visibility to return status. ## Tools ### create_logistics_order This tool creates a new fulfillment order for an end customer. ### get_inbound Retrieves detailed information about specific inbound inventory shipments. ### get_logistics_order Fetches the full details for a given fulfillment order number. ### get_product Gets detailed metadata and information about a specific product SKU. ### get_return Retrieves the current status and details for a customer return request. ### get_warehouse_network Lists all operational warehouses in the Flexport fulfillment network. ### list_inbounds Shows a list of all expected and currently monitored inbound shipments. ### list_inventory Checks and reports current stock levels for specified SKUs across the network. ### list_labels Generates a list of purchased shipping labels ready for use with e-commerce shipments. ### list_logistics_orders Provides a summary list of multiple fulfillment orders that have been created or processed. ### list_products Returns an overview of the entire product catalog managed by Flexport. ### list_returns Lists multiple customer return requests, summarizing their status and history. ## Prompt Examples **Prompt:** ``` Check the current inventory level for SKU 'SKU-999'. ``` **Response:** ``` Checking inventory... For SKU 'SKU-999', you have 150 units available across the network, with the largest concentration in the California fulfillment center. ``` **Prompt:** ``` List all fulfillment orders that were shipped today. ``` **Response:** ``` Retrieving orders... I found 12 fulfillment orders shipped today, including orders for 'Customer A' and 'Customer B'. Would you like the tracking numbers for these shipments? ``` **Prompt:** ``` Show me the status of my inbound shipment 'INB-123'. ``` **Response:** ``` Fetching inbound details... Shipment 'INB-123' is currently 'In Transit' and is expected to arrive at the warehouse by Friday. I'll notify you once it's been received and processed. ``` ## Capabilities ### Generate Fulfillment Orders Creates and tracks new shipping requests for your end customers across all sales channels. ### Check Live Stock Levels Retrieves current product counts from the entire Flexport warehouse network to prevent stockouts. ### Monitor Incoming Shipments Lists and tracks details for inventory shipments en route to your warehouses. ### Retrieve Product Information Accesses detailed metadata and libraries for specific products (SKUs). ### Manage Customer Returns Gathers information about customer return requests and tracks the status of returned items. ### List Shipment Labels Retrieves purchased parcel shipping labels needed for your e-commerce shipments. ### View Warehouse Locations Gets a list of all active warehouses operating within the Flexport network. ## Use Cases ### Investigating a Missing Product Shipment A warehouse manager asks their agent, 'Where is our latest shipment of widgets?' The agent executes `list_inbounds` and identifies the inbound manifest ID ('INB-123'), showing its current status and estimated arrival date at the local facility. ### Handling a Customer's Urgent Order Query A customer service agent needs to know the status of an order. They ask their agent to check the fulfillment details, which triggers `get_logistics_order` and immediately provides the current tracking number and expected delivery time. ### Preparing for a New Sales Campaign An e-commerce merchant needs to know if they can promise 50 units of an item. They ask the agent, 'Check stock for SKU XYZ,' which runs `list_inventory` and confirms available quantities across all regional centers. ### Processing a Bulk Return Batch A returns specialist needs to process five returned items. Using their agent, they run `list_returns`, generating a list that shows the status of each item—whether it's inspected, pending credit, or rejected. ## Benefits - Stop manually cross-referencing multiple systems. Your agent can check live stock levels (using `list_inventory`) across the entire warehouse network in one prompt. - Accelerate customer support. Instead of searching through databases for tracking numbers or return status, your agent fetches all that data instantly using tools like `get_return` and `get_logistics_order`. - Streamline fulfillment setup. You can automate order creation (`create_logistics_order`) and simultaneously pull the required shipping labels (`list_labels`) in a single conversational flow. - Gain full supply chain visibility. Get an immediate overview of what's coming in (using `list_inbounds`) or where it needs to go by checking the entire warehouse map (`get_warehouse_network`). - Cut down on product research time. Quickly fetch detailed metadata for any item using `get_product` so your team never has to guess about an SKU's specifications again. ## How It Works The bottom line is that you talk naturally to your AI client and get actionable, real-time logistics data back. 1. Subscribe to this MCP via Vinkius Marketplace and provide your required Flexport Logistics API Key. 2. Your agent uses the key to connect, giving it immediate access to global fulfillment data. 3. You ask a question or give a command—like 'What is the stock for SKU X?'—and your agent executes the necessary logistics tool call. ## Frequently Asked Questions **How do I use the Flexport Logistics MCP to check stock levels?** You ask your agent to list inventory and provide the specific SKU. The tool `list_inventory` checks current stock counts across the entire network, telling you exactly what's available right now. **Can I use Flexport Logistics MCP to create a new order?** Yes, you can tell your agent to create an order using `create_logistics_order`. This handles the initial fulfillment setup for your customer across all necessary channels. **Does this MCP help with returns processing? (Flexport Logistics)** It does. You can use `list_returns` to see a summary of multiple return requests and then use `get_return` for the detailed status of one specific item. **Which tool do I use to find out what products Flexport carries?** Run `list_products`. This tool gives you an overall catalog view, while if you need details on a single SKU, use the `get_product` tool. **What is the difference between list_inbounds and list_inventory?** Use `list_inbounds` when you want to know about shipments that are *on the way* to the warehouse. Use `list_inventory` when those items have arrived and are counted as available stock.