transfer_inventory
Updated September 9, 20261 min read
Transfer on-hand inventory between two locations. This is an MCP convenience wrapper, not a first-class backend API. It submits paired TRANSFER_OUT and TRANSFER_IN events with the same request.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
destination_location_id | string | Yes | — |
event_timestamp | string | Yes | ISO 8601 event timestamp. Backend rejects future timestamps and timestamps older than the tolerance window. |
quantity | number | Yes | Positive on-hand quantity to move from source to destination. |
source_location_id | string | Yes | — |
tenantId | string | Yes | — |
inventory_key | string | No | — |
merchant | string | No | — |
product_id | string | No | Product whose inventory_key identifies the inventory. |
product_ref | string | No | Merchant product reference; requires merchant. |
reason | string | No | — |
sku | string | No | Merchant SKU; requires merchant. Rejected when ambiguous. |
Example agent prompt
"Transfer inventory between locations."
transfer_inventory(
tenantId="…",
product_id="PROD-1234",
source_location_id=…,
destination_location_id=…,
quantity=5,
event_timestamp=…
)