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. After a timeout, read get_cart before you try again. Can take up to 90 seconds.

What it does

Brings a saved cart back: re-prices every store and returns the cart with what changed at each. Show the changes to the shopper before they approve.

Inputs

Returns

Example call

Notes

  • A change’s outcome is ready, changed, checking, needs_input, unavailable, or failed. before is the total the shopper last saw, and now is the total the store reads now.
  • A change with reason: replace_account_cart waits on the shopper. Once they agree, call again with replace naming that line_key and its holds.token.
  • reason says more about a change: fees_pending (the store has not added its fees, so now is the items alone), sold_out, offer_expired (a fare, a room or a time is gone, and ask.options lists close choices still open), offer_gone (the store no longer lists the product), currency_changed, and replace_account_cart.
  • Show a change with fees_pending as an estimate, and get the total with fees before the shopper pays.