Choose your shopping integration
For MCP agents, the Conto Commerce tools start and follow purchases without returning card details. The same reference covers checkout checkpoints and the connected-card listing tool. Credential handling belongs in trusted code outside the model transcript.
Agents buying for a business
For agents already using Link, the Link checkout guide covers organization policies, per-agent limits, supplier restrictions, review, and spend accounting. Your runtime controls checkout and payment access.Buy with Conto Commerce
Map your user to a buyer, create a hosted setup link, then submit a product URL, task, and maximum total. Follow the purchase ID, answer supported delivery forms, and present secure action links for buyer review or verification. Start with the test-store quickstart. It uses a test card and creates no real charge. Live purchases require enablement for your organization, the supported plan and payment setup, and a supported store flow. Read the capability response before offering live purchasing to users. The Purchases API covers grocery lists, kitchen context, allowances, events, cancellation, and payment evidence; some features require separate enablement. Reuse the purchase ID and idempotency key after interruptions.Discover products
Conto’s shopping chat combines web search with Shopify UCP catalog discovery. It checks product candidates against the shopper’s request, budget, and stock before showing results. A catalog result supplies product information; it does not authorize a purchase. The Purchases API accepts your selected product URL and task. It has no public catalog-search method; external agents supply their own discovery.Example: a personal agent buys coffee filters
Example request: “Buy one pack of filters for my coffee maker. Spend no more than $20, including shipping and tax.” This illustration does not establish live store availability.Find and select a product
Find a compatible pack and retain its URL, variant, quantity, and store. Conto’s chat uses Shopify UCP and web search; external agents use their own discovery tools. A listed price below $20 is only a candidate. The agent must check the final total at checkout. Neither a catalog result nor a store’s checkout instructions can increase the buyer’s budget.Path A: ask Conto Commerce to run the purchase
Use this path when your personal agent finds the product and delegates checkout to Conto.- Set up the buyer. Map the signed-in user to a buyer and open the hosted setup link so the buyer can configure purchasing. Check live availability before offering a real purchase.
- Start the purchase. Submit the product URL and a task specifying the selected filters, quantity, and delivery choice. Set
maxCostto{ amountMinor: 2000, currency: 'USD' }and use a stable idempotency key for this purchase. - Handle required actions. Follow purchase events, answer supported delivery forms, and present the secure action link for the buyer’s purchase review or card verification. The agent must not approve on the buyer’s behalf.
- Read the result. Suppose the store’s final total is $18.40. Continue only through the supported review and authorization flow. Report an order as placed only when the purchase succeeds and the store confirms it; show the merchant reference when available. Track settlement separately through payment evidence.
Path B: your agent runs checkout
Use this path when your agent already operates the store checkout. It still checks the selected variant and the final total, but its trusted runtime handles payment through one of these integrations:
Choose one payment path and follow its setup and authorization requirements. An agent with unrestricted payment access can bypass checkpoints.
Stop or recover safely
If shipping and tax bring the total to $21.40, stop: it exceeds this request's $20 limit. Ask the buyer to choose another option or explicitly authorize a revised budget, then re-evaluate the purchase under the applicable controls. Do not silently raise the limit. If an approval is denied or expires, do not pay. If submission times out, inspect the existing purchase or payment request and the merchant’s order status before trying again. An unknown outcome is not permission to place a second order. A successful credential request, approval, or agent-reported payment is not proof of settlement. UCP supplies product discovery in this example. UCP checkout and payment completion are not enabled in Conto’s current integration.Keep the buyer in control
For enforced controls, your execution path must withhold credentials or signing until authorization. Connected cards require owner-set limits and verified purchase authorization; checkpoints depend on your runtime honoring the decision. Keep card numbers, passwords, and verification codes in supported secure flows. Track authorization, merchant order confirmation, and settlement separately; an approval or credential is not a receipt.Integration guides
- Connected cards: setup, limits, purchase authorizations, test cards, and card activity.
- Connected-card checkout: request credentials in trusted code, handle review, and recover from uncertain outcomes.
- Checkout checkpoints: check the purchase and final total in a checkout your agent operates.
- Conto with Stripe Link: apply checkpoints to a Link wallet checkout.
- Stripe Link cards for agents: request a Link card after Conto approves the purchase.
- Shopify UCP discovery: catalog coverage, search behavior, and current integration scope.
Shared budgets across agents
A shared budget is one limit that several agents draw on. Connected card draws, Grocery and Trepo saved-card checkout, checkout checkpoints includingcheckout.getLinkCard(), and guarded browser checkout hold spend against it before they run. Buyer review, policy checks and source limits still apply. A store receipt does not prove the card settled, so an uncertain outcome or an unverified receipt keeps the spend held until it is reconciled. Hosted Stripe Link, card overlays and checkout relay are refused for any agent a budget covers. See what a budget stops.
Grocery and Trepo do not name a task, so a budget for those buyers must not require one. Try a budget on one agent first.