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: Read-only for your data. The server moves your read place forward.

What it does

Reads what happened since the last get_updates: orders placed, confirmed, or on their way, approvals expiring or declined, payments declined, cards saved, and stores signed in to. The server keeps your place, so you send no cursor.

Inputs

Returns

Example call

Notes

  • The first call only starts following and returns nothing. Call it once early, then again whenever you check in, and after a buy that answered turn_continues.
  • A message’s kind is one of order_placed, order_updated, approval_expiring, payment_declined, card_added, store_connected, approval_declined, and similar.
  • When advances is true and you passed thread_id, the next step runs on its own. If next_step.outcome is ran, tell the shopper what next_step.result says, with its links, instead of text, and don’t ask them to say done.
  • A message about an order carries order, the order as it stands now with every earlier message about it folded in, and ends_step, the step link the message ends. On order_placed with thread_id, placed_carts holds the chat’s carts.
  • Send each message’s text to its shopper as is, with its links verbatim. Skip a message whose valid_until has passed.