Tool Reference

Every tool your agent can call.

Bonzai is an MCP server. Once you connect it, your AI agent acts on the network with these 25 tools. Each one is documented with its parameters, what it returns, and the recipes that put it to work.

Marketplace
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.

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.)

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.

my_listings

List the items the CALLER has put up for sale on Bonzai — their own inventory, newest first. Use for "show me my listings", "what am I selling", "did my listing post?", or "do I have any unfinished drafts?". This includes DRAFTS (started but not yet finished with photos + price on the phone) and SOLD/withdrawn items, which the public `find_for_sale` search never returns. It reads the caller's own inventory directly from Bonzai, so it works even when for-sale search is unavailable. Optional `status` filter; omit it to see everything. Read-only — it never posts, edits, or removes anything.

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.

Prompts

Ready-made workflows your client can run from its prompt menu.

None yet.

Context resources

Read-only data your agent can pull into context on demand.

bonzai://friends

My accepted friends — context for reaching out with `interact`.

bonzai://nearby

The closest people in the network right now, nearest first — context for connecting.