ucp

When a buyer expresses commercial intent — wanting to find, buy, or track products — this is your toolkit. You can search across thousands of merchants via a bundled global catalog, build carts and complete checkouts against any UCP-supporting merchant, and follow up on orders. For merchants that don't support direct transactions, hand off gracefully to the merchant's own flow.

How to decide what to do

Rule of thumb: broad product discovery → global catalog (no --business needed). Business-scoped operations — cart, checkout, order, or catalog scoped to a specific merchant — → pass --business <url>. Reach for one or the other based on the buyer's intent.

Required local setup

Before any merchant-scoped flow — discover, cart, checkout, order, or catalog requests with --business — ensure a local profile exists.

If you return a merchant-scoped command to the user, include a profile-init step first unless the user explicitly told you a local profile already exists and is healthy. The profile name is just a local label — agent is a fine default, not a required magic value.