Less repeated entry
Product codes, recipient details, SKU quantities and service instructions move into the existing warehouse workflow through one structured submission.
Guide · Connected logistics
What is MCP for logistics?
MCP for logistics connects an authorized AI assistant to shipping operations through the Model Context Protocol. WooliiPorter’s standalone server exposes the same Merchant API used by business integrations, so your back office can select a shipping product, estimate freight, create orders, follow inventory and tracking, and reconcile settlement through structured tool calls.
How does a connected operating backend improve shipping?
WooliiPorter connects order intake, warehouse work, inventory, international shipping and settlement in one operating backend. Structured interfaces let your team reuse the same shipment data across store apps, internal systems and authorized assistants. Each update carries a business identity, so an order can move from receipt to delivery with a continuous record.
Current inventory and shipment status
Inventory reads use the movement ledger. Public shipment tracking merges normalized events behind a stable WooliiPorter WP number.
Clear costs and operational actions
Estimates support planning; packed quotes and itemized settlement support payment. Missing stock, declarations or setup return the action needed to move the order forward.
How do I run the shipping workflow?
- 1
Select your shipping product
Read list_shipping_products, choose a product that supports your destination and cargo, then pass its productCode to the estimate and order. A saved account default is also an explicit choice. Each product uses its configured service for that country.
- 2
Estimate and submit the work
Estimate using package weight, dimensions and postcode. For pure batteries, include the number of individual batteries per physical package. Submit the pre-alert with domestic parcel numbers, full customer declared values and complete warehouse service instructions.
- 3
Follow warehouse execution
Receipt, inspection, consolidation and packing progress appear in the order timeline. Packed measurements produce the final quote. Stocked fulfillment checks declarations, product eligibility, inventory and wallet funding before reservation.
- 4
Read settlement and authorize payment
Retrieve the packed quote and line-item bill. Customer taxes use complete declared values; applicable EU charges count distinct confirmed HS codes within each physical package. Your authorized payment workflow uses the final bill.
- 5
Keep your systems current
Read shipment-native tracking with stable WooliiPorter WP numbers. Your API webhook receiver can consume signed status events; incremental reads reconcile the current order, inventory and shipment state.
Which tools can I use?
Contract 2026-10-28.1. Each tool inherits its API endpoint’s account, environment, scopes and business checks.
| Tool | Purpose |
|---|---|
create_forwarding_order | Pre-alert an order: parcels, destination, value-added service requests. Idempotent per externalOrderId. |
estimate_shipping_cost | Estimate the selected public product with current prices and measurements; final packed pricing adds applicable declaration-based fees. |
get_order | Read one order, including value-added service progress. |
list_orders_updated_since | Incremental polling: orders changed since a timestamp. |
get_packed_quote | Final packed quote and transit ETA. |
get_settlement | The line-item bill — every charge explainable. |
pay_order | Legacy entry: production payment is unavailable; migrate explicitly. |
pay_order_from_wallet | Pay a confirmed quote with finance:pay, a settlement version and idempotency key. |
get_tracking | Normalized carrier tracking for every outbound package. |
get_timeline | Unified China-leg + carrier-leg event timeline. |
list_shipments | Cursor-paginated unified shipments, filterable by source, status, tracking and update time. |
get_shipment | One shipment with public service, parcels, merchant sell quote and normalized events. |
get_shipment_tracking | Shipment-native WooliiPorter tracking for every outbound parcel. |
cancel_order | Cancel while the order is still awaiting parcels. |
cancel_fulfillment_intent | Cancel one unified commerce fulfillment intent; the outcome distinguishes terminal cancellation from warehouse or admin review. |
register_sku | Register or update a merchant SKU (upsert by skuCode) — required before stocking or fulfillment. |
get_sku_cpsc | Read the US CPSC certificate of a SKU and its filing status. |
save_sku_cpsc | Create or replace the US CPSC certificate of a SKU; changes require a new filing before US shipment. |
create_inbound_shipment | Create a stocking/FBA/FBM inbound and receive an IB inbound number and address; no supplier tracking is required. |
get_inbound_shipment | Read one inbound by public IB number, including carton progress and customer-safe exception state. |
get_inventory | Live stock levels per SKU per warehouse plus aging, from the immutable movement ledger. |
create_fulfillment_order | Create a dropship order from stocked inventory — auto-confirms and reserves FIFO; ON_HOLD names any shortfall. |
confirm_fulfillment | Confirm a draft order, or retry reservation on an on-hold order after restocking. |
get_statement | Monthly statement: per-lot storage fees plus fulfillment fees, every line explainable. |
list_shipping_products | Public shipping products and saved account/store defaults. |
list_shippable_countries | Destinations with a live configured route. |
How do apps and APIs work together?
- The Shopify app is available on the Shopify App Store. Shopify installation and assigned fulfillment orders connect the store to the shared WooliiPorter backend.
- The WooCommerce plugin is available through WordPress.org at stable version 0.7.0. Active merchants can download the reviewed 0.9.0 package from their Integrations workspace for the latest product-selection workflow.
- The standalone MCP server uses your Merchant API key in your own runtime. REST clients and MCP tools read the same public products, quotes, inventory and shipment records.
Set your shipping product and warehouse service instructions first. Review mixed stocked/forwarding orders through the merchant workflow and authorize payment against the complete itemized settlement. The backend then progresses eligible work through inventory reservation, packing, booking and physical handover.
Common questions
What is MCP for logistics?
MCP for logistics connects an authorized AI assistant to shipping operations through the Model Context Protocol. WooliiPorter’s standalone server exposes the same Merchant API used by business integrations, so your back office can select a shipping product, estimate freight, create orders, follow inventory and tracking, and reconcile settlement through structured tool calls.
How many WooliiPorter tools are available?
26 tools in the standalone stdio adapter, covering public product discovery, forwarding, estimates, quotes, payment, shipments, inventory, fulfillment and statements. The complete tool inventory below follows the current API reference.
How does product selection work?
Select a public productCode or use a saved explicit default. WooliiPorter validates destination, cargo, warehouse purpose, postcode, weight and dimensions against that product. The selected product and country determine the configured transport service.
How do I connect my assistant?
Apply through your WooliiPorter merchant account, create an approved sandbox API key and configure the standalone MCP server in your own runtime. It uses the same account, environment and scopes as Merchant API V1. The developer reference contains the client configuration.
How does MCP relate to store apps?
MCP connects your own assistant or back-office runtime. WooCommerce and Shopify connect store orders directly to the WooliiPorter operating backend. They share product selection, inventory, warehouse execution and public shipment records.
Connect your back office
Start with a merchant sandbox key and the current product catalog. Validate a forwarding order, stocked fulfillment and the final settlement flow before switching your integration to production.