# Flexport MCP for AI Agents AI Agent Connect > Flexport MCP lets you manage global freight shipments, purchase orders, and logistics documents directly through your AI agent. It gives you real-time visibility into your supply chain, allowing you to track ocean and air cargo, manage the lifecycle of purchase orders, and pull critical documents like Bills of Lading or Commercial Invoices without leaving your chat interface. ## Overview - **Category:** erp-operations - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_f2LQY2qm6SfEuHLTo4K9KyiSmoDb3VOKl5P1pm0Z/ai-agent-connect - **Tags:** freight-forwarding, global-trade, shipment-tracking, purchase-order-management, logistics-documentation, supply-chain-visibility ## Description This Connector connects your account to any AI agent, giving you a direct line to your global trade and freight operations. Instead of hunting through different dashboards to see where a container is or to find a specific invoice, you can just ask your agent for the information you need. It handles the heavy lifting of navigating the logistics platform to pull real-time tracking metadata, freight invoices, and customs documentation. You can manage the full lifecycle of your purchase orders, from creation to retrieval, and keep your financial records organized by pulling commercial invoices on demand. By connecting this through the Vinkius catalog, you turn your AI into a logistics coordinator that knows your supply chain inside out, letting you focus on moving goods rather than chasing paperwork. You can use it to quickly pull data for customs clearance, monitor transit statuses for ocean and air freight, and manage your purchase order lifecycle without ever opening a browser tab. Whether you're checking cargo ready dates for a carrier or grabbing a Bill of Lading for a customer, the information is always just one question away. This replaces the need to manually toggle between your logistics tools and your communication channels, allowing you to handle complex international shipping workflows through simple conversation. You can move from a reactive state of searching for information to a proactive state of managing your cargo with just a few words. ## Tools ### list_commercial_invoices See all your commercial invoices in one list. This helps you stay on top of your customs paperwork. ### create_purchase_order Create a new purchase order directly from your AI client. This saves you from manual entry in the portal. ### download_document Get a secure link to download a specific logistics document. This lets you grab files without navigating menus. ### get_document See the metadata for a specific logistics document. Use this to verify details before downloading. ### get_invoice Pull the specific details for a single invoice. This is great for deep dives into billing. ### get_purchase_order See the full details of a specific purchase order. Use this to check line items and statuses. ### get_shipment Get the full details of a specific shipment. This provides everything you need to know about a single cargo move. ### list_documents Browse all logistics documents associated with your account. It's the fastest way to find your paperwork. ### list_invoices View a list of all freight invoices. Use this to keep your shipping costs organized. ### list_purchase_orders See all your active and past purchase orders. It helps you track what's been ordered and what's pending. ### list_shipment_invoices Find all invoices tied to a specific shipment. This makes it easy to see the costs for a single delivery. ### list_shipments Get a list of all your ocean and air shipments. Use this to see your entire cargo pipeline at once. ## Prompt Examples **Prompt:** ``` List my 5 most recent freight shipments and their status. ``` **Response:** ``` Fetching shipments... I found 5 recent shipments, including: | Shipment ID | Status | Mode | | :--- | :--- | :--- | | SHIP-123 | In Transit | Ocean | | SHIP-456 | Arrived | Air | | SHIP-789 | Pending | Ocean | | SHIP-101 | In Transit | Air | | SHIP-202 | Arrived | Ocean | Would you like the tracking details or associated documents for any of these? ``` **Prompt:** ``` Show me all purchase orders pending for this quarter. ``` **Response:** ``` Retrieving purchase orders... You have 8 active POs, with 3 marked as **Pending Vendor Confirmation**. **Pending Orders:** - PO-9982 (Electronics) - PO-9985 (Packaging) - PO-9990 (Hardware) Would you like me to drill down into the line items for these pending orders? ``` **Prompt:** ``` Get the download link for the Bill of Lading for shipment 'SHIP-789'. ``` **Response:** ``` Generating document link... I've retrieved a secure temporary link for the Bill of Lading associated with **SHIP-789**. You can download the file here: https://api.flexport.com/documents/doc_abc/download *Note: This link will expire in 24 hours.* ``` ## Capabilities ### Track shipment statuses See real-time updates for ocean and air cargo shipments. ### Create purchase orders Generate new purchase orders directly from your chat interface. ### Retrieve logistics documents Fetch Bills of Lading, Packing Lists, and other key paperwork. ### List freight invoices View all freight and commercial invoices associated with your account. ### Monitor purchase order lifecycles Check the status of pending or completed purchase orders. ### Access customs data Pull commercial invoice data needed for customs clearance and compliance. ## Use Cases ### Tracking a delayed shipment A logistics manager asks the agent for the status of a specific ocean shipment and gets the current location and transit status immediately using `get_shipment`. ### Batch invoice gathering A finance lead asks the agent to list all freight invoices from last month to prepare for a monthly audit using `list_invoices`. ### Quick PO creation A procurement officer tells the agent to create a purchase order for a new batch of supplies, and the agent handles the entry using `create_purchase_order`. ### Document hunting A customs broker needs a Bill of Lading for a specific shipment and asks the agent to provide the download link using `download_document`. ## Benefits - Stop tab-switching by accessing shipment tracking and purchase orders in one place. Use `list_shipments` to see your entire cargo pipeline instantly. - Speed up procurement by using `create_purchase_order` to generate new orders without leaving your chat. This removes the need for manual data entry. - Simplify document retrieval with `download_document` and `get_document`. You can grab Bills of Lading and Packing Lists in seconds. - Improve financial oversight by using `list_invoices` and `get_invoice`. Keep all your freight and commercial costs organized in one view. - Get better visibility into your supply chain by using `list_purchase_orders`. You can see what's pending and what's moving at a glance. - Simplify customs compliance by quickly pulling commercial invoice data with `list_commercial_invoices` whenever you need it. ## How It Works The bottom line is you get a centralized way to manage global freight and documentation through a single conversation. 1. Subscribe to the Flexport MCP on the Vinkius Marketplace. 2. Enter your Flexport API Key from your Developer Portal into your AI client. 3. Ask your agent to list shipments, pull invoices, or create purchase orders. ## Frequently Asked Questions **Can the Flexport MCP track my ocean and air shipments?** Yes, it allows your agent to list all your shipments and fetch real-time tracking metadata for both ocean and air cargo. **Can I create new purchase orders using this tool?** You can use your AI client to create new purchase orders directly, which saves you from having to manually enter data into the Flexport portal. **How do I get logistics documents like Bills of Lading?** Your agent can list all your logistics documents and provide direct download links for files like Packing Lists and Commercial Invoices. **Can this Connector help with freight billing?** It can list all your freight invoices and pull specific invoice details, making it much easier to manage your shipping costs and financial records. **Is this useful for customs clearance?** Yes, it can retrieve commercial invoice data required for customs compliance, helping you keep your documentation organized and accessible. **How do I connect Flexport to my AI agent?** You just need to subscribe to the Connector on Vinkius and add your Flexport API key from your developer portal to your preferred AI client. **How do I track a specific shipment using its ID?** You can use the 'get_shipment' tool and provide the Flexport Shipment ID. The agent will return the most recent status, location, and estimated arrival dates for that shipment. **Can I retrieve commercial invoices for customs purposes?** Yes! The 'list_commercial_invoices' and 'list_documents' tools allow you to access the necessary paperwork for customs clearance. You can even use 'download_document' to get a temporary link to the actual file. **Is it possible to filter invoices by shipment?** Absolutely. Use the 'list_shipment_invoices' tool and provide the Shipment ID. The agent will retrieve all freight billing documents associated with that specific cargo movement.