Skip to main content
Connect to https://mcp.opencommerce.sh/mcp with your Commerce SDK credentials as Authorization: Bearer <YOUR_CLIENT_ID>:<YOUR_CLIENT_SECRET>. See Connect your agent. Behavior: Changes state. Not safe to repeat after a timeout: read get_conversation first.

What it does

Changes a multi-item plan, such as a gift guide, a party list, or a trip, that a buy result showed. Use it only for a change the shopper asked for. Picks are named by their rank in the plan, from 1.

Inputs

Returns

Example call

Notes

The change object takes one of these shapes:
  • The errors no_guide, no_such_pick, not_a_swap, nothing_to_undo, and guide_full mean the plan can’t take that change. guide_busy clears after a short wait.
  • To add a pick to the cart, call buy with that pick’s product_id.