Buy

The agent-cards buy surface lets you shop at linked merchants and check out with a virtual card. The fastest way is natural language; granular subcommands exist for scripted or expert use. For the bigger picture, see the Shopping guide.

Chat to shop

agent-cards buy                                  # open the buy chat
agent-cards buy the caesar salad from Zuni on doordash   # seed the chat with a request
agent-cards buy chat --resume <id>               # resume a conversation

Bare buy (or any free-text after buy that isn’t a subcommand) opens the conversational buy agent, which walks you through finding items, building a cart, and checking out.

Link a merchant

agent-cards buy merchants                        # list merchants and link status
agent-cards buy link <merchant> --email <e> --first-name <f> --last-name <l> --phone <p>
agent-cards buy confirm <merchant> --pending <pendingId> --code <code>
agent-cards buy connect <merchant>               # link by logging in via a hosted browser (doordash)
agent-cards buy unlink <merchant>                # disconnect a merchant

Supported merchants include rappi, goodeggs, and doordash.

Browse and build a cart

agent-cards buy stores <merchant> <query>        # find stores within a multi-store merchant (DoorDash)
agent-cards buy store <merchant> <storeId>       # scope searches + cart to one store
agent-cards buy search <merchant> <query>        # search a merchant for products
agent-cards buy cart <merchant>                  # view the cart
agent-cards buy add <merchant> <productId> [--quantity <n>]
agent-cards buy qty <merchant> <productId> <quantity>     # set quantity (0 removes)
agent-cards buy remove <merchant> <productId>
agent-cards buy clear <merchant>                 # empty the cart

Budgets

agent-cards buy budget <period> <limitDollars> [--timezone <tz>]

Set a spend budget where period is daily, weekly, monthly, or total.

Check out

agent-cards buy checkout <merchant> --yes

Checkout is destructive (it places and pays for the order) and requires --yes.

Option	Description
`--yes`	Confirm placing the order.
`--tip <dollars>`	Dasher tip in dollars; added to the charge and card size.
`--schedule <iso>`	Schedule delivery for an ISO-8601 time; default is ASAP.
`--approval <approvalId>`	A spend approval id, if checkout returned `needs_approval`.
`--idempotency-key <key>`	Reuse the same key on a retry so a timed-out call never double-charges.

Orders

agent-cards buy orders <merchant> [--limit <n>]              # recent order history (max 50)
agent-cards buy reorder <merchant> <orderId>                 # re-create a cart from a past order
agent-cards buy track <merchant> <orderId>                   # status + ETA for a placed order
agent-cards buy substitution <merchant> <orderId> <itemMsid> <preference>   # similar | refund | contact

Delivery addresses

agent-cards buy addresses <merchant>                  # list saved delivery addresses
agent-cards buy set-address <merchant> <addressId>    # set the default delivery address

Get Started

CLI

MCP

Guides

Concepts

Chat to shop

Link a merchant

Browse and build a cart

Budgets

Check out

Orders

Delivery addresses

​Chat to shop

​Link a merchant

​Browse and build a cart

​Budgets

​Check out

​Orders

​Delivery addresses

Chat to shop

Link a merchant

Browse and build a cart

Budgets

Check out

Orders

Delivery addresses