# Duoplane MCP MCP > Duoplane lets your AI agent manage complex multi-vendor operations. Track every customer order across multiple storefronts, monitor purchase orders sent to vendors, and audit synchronized inventory data all through natural conversation. ## Overview - **Category:** ecommerce - **Price:** Free - **Tags:** drop-shipping, multi-vendor, purchase-orders, catalog-sync, vendor-management, order-automation ## Description This connector gives your AI client deep access into the entire duoplane ecosystem. It handles the chaos of e-commerce fulfillment that spans multiple partners and platforms. You can tell your agent to list every customer order and get its current status instantly, or track a specific purchase order from submission through real-time shipping history. Need to vet a vendor's connection status? Your agent pulls up their full profile immediately. It also aggregates high-level inventory summaries across all synchronized products. When you connect this MCP via Vinkius, your AI client can orchestrate these details—from checking out an order detail to listing active vendors—without ever opening a dashboard or copying a tracking number. You're running the fulfillment process through conversation. ## Tools ### get_duoplane_account_metadata Pulls general metadata about your current Duoplane account subdomain. ### get_order_details Retrieves all status and detail information for one specific customer order. ### get_purchase_order_details Gets comprehensive details, including the history, of a single purchase order. ### quick_vendor_inventory_audit Pulls an immediate, high-level summary of product counts and overall vendor activity. ### get_vendor_profile Displays the full profile and configuration settings for any specific vendor account. ### list_ecommerce_orders Lists every customer order currently held within your Duoplane account for review. ### list_purchase_orders Retrieves a list of all purchase orders (POs) that have been sent to vendors. ### list_unfulfilled_purchase_orders Identifies and lists all purchase orders that are currently waiting for fulfillment from a vendor. ### list_synced_products Provides an inventory listing of every product synchronized across your storefronts and vendors. ### list_active_vendors Generates a list of all current drop-ship and wholesale vendors registered in your system. ### search_orders_by_reference Searches for customer orders using any known keyword or reference ID number. ## Prompt Examples **Prompt:** ``` List all unfulfilled purchase orders. ``` **Response:** ``` I've found 5 unfulfilled purchase orders, including PO-9988 sent to 'Vendor A' and PO-7766 sent to 'Vendor B'. Would you like to see the items for PO-9988? ``` **Prompt:** ``` Show me the details for customer order '12345'. ``` **Response:** ``` Order '12345' (External ID: WEB-101) is currently 'Partially Shipped'. It contains 3 items across 2 different vendors. Should I pull the tracking numbers for the shipped portion? ``` **Prompt:** ``` List all active vendors and their status. ``` **Response:** ``` You have 8 active vendors, including 'DropShip Plus' (Connected) and 'Wholesale Direct' (Connected). 1 vendor is currently 'Disconnected'. Would you like to see the profile for the disconnected vendor? ``` ## Capabilities ### Audit Product Inventory Get high-level counts and summaries of products across all connected vendor stores. ### Track Specific Customer Orders Pull detailed information and current fulfillment stages for any given customer order ID. ### Manage Vendor Status List all registered drop-ship and wholesale partners, checking their connection status and configuration details. ### Monitor Purchase Order Progress Check the history and current fulfillment status of any purchase order sent out to a vendor. ### Search Orders by Reference Find customer orders quickly using an external ID or keyword instead of the internal order number. ## Use Cases ### Reconciling Stock Discrepancies The stockroom reports that the widget count is wrong. Instead of manually comparing spreadsheets, your agent runs `list_synced_products` to see what the system thinks the inventory is, then uses `quick_vendor_inventory_audit` to confirm vendor activity against the expected counts. ### Investigating a Delayed Shipment A customer complains their order 'XYZ' is late. You tell your agent to first use `search_orders_by_reference`, then run `get_order_details` on the returned ID, and finally check if there are any related unfulfilled POs using `list_unfulfilled_purchase_orders`. ### Vetting a New Vendor Partner Before adding a new partner to your network, you ask your agent to first list all existing vendors via `list_active_vendors`, then retrieve the profile for the potential new vendor using `get_vendor_profile` to ensure all necessary connection settings are correct. ### Auditing Quarterly Purchases It's time to review all buying activity. You ask your agent to first list every purchase order (`list_purchase_orders`), and then loop through them, pulling specific details using `get_purchase_order_details` for compliance checks. ## Benefits - Stop guessing where a product is. Use `quick_vendor_inventory_audit` to get an immediate summary of vendor activity and overall stock counts without running complex database queries. - Instantly pinpoint bottlenecks using `list_unfulfilled_purchase_orders`. Your agent tells you which POs are stuck, letting you know exactly who needs a nudge from your side. - Avoid manual searching. If you only have a tracking number or an external ID, use `search_orders_by_reference` to pull up the exact order details immediately. - Get full visibility into partners using `list_active_vendors`. You can quickly check if a vendor is connected and what their specific profile settings are with `get_vendor_profile`. - Track every step of the money trail. By listing all purchase orders (`list_purchase_orders`) and checking individual PO details, you know exactly when goods left your system. - Find any order, no matter how old or complex. Running `list_ecommerce_orders` gives a full list, but using `get_order_details` allows deep dives into specific items and fulfillment stages. ## How It Works The bottom line is, you get a single conversational interface to manage complex fulfillment logic across dozens of vendor endpoints. 1. Connect the Duoplane MCP to your AI client and authorize it using your API keys. 2. Instruct your agent on the specific task, like 'List all unfulfilled purchase orders' or 'Get details for order 12345'. 3. Your agent executes the necessary tool calls, returning structured data that answers your question in conversation. ## Frequently Asked Questions **How do I find an old customer order using the get_order_details tool?** You first use `search_orders_by_reference` with a keyword or external ID. This returns the specific order ID, which you then feed into `get_order_details` to pull all associated status information. **What is the difference between list_purchase_orders and list_unfulfilled_purchase_orders?** The general function `list_purchase_orders` shows every PO ever sent. The specialized tool, `list_unfulfilled_purchase_orders`, filters that list down to only those purchase orders actively waiting for the vendor to ship goods. **Can I check if a vendor is active using list_active_vendors?** Yes. `list_active_vendors` lists all registered partners, showing their current status (e.g., Connected or Disconnected) right in the results. **Do I need to use get_vendor_profile for every vendor?** No. Use `list_active_vendors` first for a quick overview. Only call `get_vendor_profile` when you need deep, specific configuration details or troubleshooting info on one particular partner. **Before querying vendor data, how do I check my connection health using get_duoplane_account_metadata?** It verifies your subdomain metadata before running complex queries. This tool confirms that your API keys and domain settings are correctly configured for Duoplane access. **If I need to pull a large volume of data, how does list_ecommerce_orders manage pagination or potential rate limits?** The MCP handles bulk retrieval by returning results in manageable pages. If you hit a rate limit, the client will pause and retry the request automatically. **What information should I expect to see when running list_synced_products for catalog auditing?** It provides a comprehensive view of every product synced across your storefronts and vendors. This lets you check synchronization status, ensuring all necessary SKUs are accounted for. **Should I use search_orders_by_reference or list_ecommerce_orders if I only know an order's external ID?** Use search_orders_by_reference. This tool is highly efficient because it targets a specific record using keywords, whereas list_ecommerce_orders returns the entire dataset. **How do I get Duoplane API credentials?** Log in to your Duoplane dashboard, navigate to **Settings > API**, and you can generate or retrieve your unique API Key. For the API Password, Duoplane typically uses 'X'. You will also need your account subdomain. **Can the agent update inventory levels?** This integration currently focuses on listing and auditing orders, POs, vendors, and products. Updating inventory levels or product details should be managed via the Duoplane portal or your e-commerce platform. **Does the integration show vendor tracking info?** Yes, you can use the get_purchase_order_details tool to retrieve tracking numbers and fulfillment status for orders handled by your vendors.