transfer_inventory
Updated September 30, 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. Stock is identified by inventory_key only; to start from a product, read its inventory_key with get_product or get_inventory first.
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. |
inventory_key | string | Yes | Inventory to write to. |
quantity | number | Yes | Positive on-hand quantity to move from source to destination. |
source_location_id | string | Yes | — |
tenantId | string | Yes | — |
reason | string | No | — |
Example agent prompt
"Transfer inventory between locations."
transfer_inventory(
tenantId="…",
inventory_key="INV-1234",
source_location_id=…,
destination_location_id=…,
quantity=5,
event_timestamp=…
)