Marketplace: buying and selling

List real things you own for sale, discover what is for sale across your network, and connect buyer to seller — all along branches of people who actually know each other.

View as Markdown (for agents)

Selling

for_sale lists a real item you own. Your agent returns a one-tap link that opens a page where you snap photos and set the price on your phone — no typing details into the chat. Every listing is public to the network.

get_listing reads back one of your listings in full — title, price, condition, photos, and a generated blurb — so your agent can describe it in your own words.

Buying

find_for_sale discovers items for sale across your network and returns them on a grid. When something is right, express_interest tells the seller and hands you the way to connect. Bonzai connects buyer and seller — it never moves money.

shop renders a storefront of items as a scrollable card for browsing.

Related tools

for_sale

Put a REAL item the user owns up for sale on Bonzai, like a classified ad — it posts PUBLICLY to the whole network (there is no friends-only or private option; do not imply one). Call this with no arguments as soon as the user wants to sell something ("sell my bike", "list this for sale", "put my couch up for sale"). Do NOT ask for or invent photos, and do NOT ask for the price or details yourself — the tool returns a one-tap link that opens a page where the user snaps/picks photos and sets the price on their phone. `title`, `price`, `condition`, and `category` are OPTIONAL pre-fills — pass them only if the user already stated them; otherwise omit. The link expires in about half an hour.

get_listing

Fetch one of the user's Bonzai for-sale listings by id (from a prior for_sale result), so you can describe it in your own words: returns the title, price, condition, the photos with their descriptions, and a generated blurb. Listings are public.

find_for_sale

Search Bonzai's public for-sale listings by keyword, with optional category, price, and locality filters ("are there any computers for sale?", "find a used road bike under $400"). Set `friends: true` to see only what the caller's friends are selling, and `nearby: true` to limit to the caller's current area ("what are my friends selling?", "anything for sale near me?"). Returns matching items plus a link to browse them all on Bonzai. This only FINDS things — it never buys: to reach a seller, use `express_interest`. Offer the user both the results here and the "see them all" link. (For the caller's OWN listings, use `my_listings`, not this.)

express_interest

Let a seller know the user is interested in one of their for-sale items (from a `find_for_sale` result). This does NOT buy anything and never handles payment — it puts the two people in touch so they can arrange the deal themselves. Pass an optional `message` to the seller. Say plainly that Bonzai connects buyer and seller only.

shop

Browse the Bonzai store and show items to buy as rich, scrollable product cards (photo, price, condition, funny description, add-to-cart). Use whenever the user wants to shop for a gift for a friend, browse the Bonzai store, or see what they can buy. Optional query filters the shelves. Returns a mock thrift-store catalog for now.