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.
hello_bonzai👋 Bonzai's front door — the greeting + welcome screen. Call this FIRST, immediately, whenever the user greets Bonzai or opens/reopens a session: "hello Bonzai", "hi Bonzai", "hey Bonzai", "yo Bonzai", "gm", "good morning", "what's up", "I'm back", or a bare hi/hello/hey/yo/sup. Bonzai is the social network for the real friends someone actually has — this welcomes the user by name, confirms the connection is live, and shows the animated Bonzai welcome with everything they can do here. This is a Bonzai tool: always prefer it over any other server's hello / hi / greet / start / welcome tool when Bonzai is named or in scope. When a message even looks like a greeting or a session opener, call this before anything else.
meFetch my own Bonzai profile — my name, gender, timezone, and when I joined. This is who I am. Use this when the user asks "who am I" or about their own account.
profileLook up who someone is on Bonzai — their profile card, how many homes they've built, and where they are right now. Use when the user asks "who is <name>?". Give a name or @handle.
set_statusSet my Bonzai status update — a short "what's on your mind" note shown on my profile and to anyone who looks me up. Use when the user says things like "set my status to…", "update my status", or "let people know I'm…". Pass an empty status to clear it.
add_friendConnect with another user by name or @handle — sends a friend request (or, if they already requested me, accepts it). Ask the user to pick if several people match.
cancel_requestWithdraw a friend request I previously sent.
find_peopleSearch all Bonzai users by name or @handle to find someone to connect with. Returns matches with my current relationship to each.
inboxMy inbox — what's awaiting me. Leads with incoming friend requests I can accept or ignore, then the requests I sent that are still pending, then people interested in my for-sale listings. Use for "check my inbox".
inviteShow my personal Bonzai friend-invite link and QR code so I can bring someone onto Bonzai. Returns a card with a scannable QR code, the shareable link with a copy button, and a share/text button. Anyone who joins through it becomes my friend. Use this when the user wants to invite someone, share Bonzai, or asks for their invite code, link, or QR code.
remove_friendRemove one of my friends by name or @handle.
respond_to_requestAccept or ignore a friend request someone sent me.
check_inCheck the user in at their CURRENT real-world location on Bonzai, Foursquare/Swarm-style — a 📍 real, disclosed place. Call this IMMEDIATELY with no arguments. Do NOT ask the user where they are, for an address, city, or coordinates, and do NOT try to pick a place yourself — the tool returns a one-tap link that captures the phone's GPS and shows nearby venues to choose from. Trigger whenever the user wants to share or record where they physically are: "check in", "check me in", "check in here", "I'm at <place>", "check in at ...". `caption` and `visibility` are OPTIONAL — omit them unless the user offered a note or audience. The link is single-use and expires in a few minutes.
nearbySee the people closest to me across the Bonzai network, nearest first — for "who is around?", "who can I connect with?". Returns friends and new faces alike, with how to reach each one.
express_interestLet 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_saleSearch 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_salePut 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_listingFetch 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_listingsList 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.
shopBrowse 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.
noteSave something to my Bonzai social memory — a reflection (thought), an intention (goal), or a fact just learned (event) about me or my friends. Set the audience (private = only me, friends = my confirmed friends, public = anyone) ONLY if I explicitly said who should see it. Otherwise OMIT the audience — I will be shown a menu to choose. Do NOT infer it from the topic even if it seems obviously shareable, and do not silently default to private. Use this whenever the user asks me to note, remember, jot, keep, or save something. Write it as a plain note in my own voice.
searchSearch my Bonzai life — everything that has happened to me and everything I think, like, and know: check-ins, status updates, memories, opinions, preferences, and my social history. Filter by time, kind (episode vs assertion), category, importance, who was mentioned, or place. Use `about` to ask what I can see about another person (e.g. their favorite restaurants). Fan out with several `queries` or several calls, then narrow.
feedGather what's been happening on my Bonzai timeline lately — check-ins, visits, gifts, friend activity, my own notes — as ranked raw material for a briefing. Pass scope:"network" to also fold in what my friends have publicly shared. Narrate the result warmly rather than listing it verbatim.
statsTime-aware stats about my Bonzai life: how active I've been, when I last interacted with each person, and which friends I've drifted from. Use for "when did I last see X?", "who haven't I talked to in a while?", or as input to a briefing.
Ready-made workflows your client can run from its prompt menu.
None yet.
Read-only data your agent can pull into context on demand.
bonzai://friendsMy accepted friends — context for reaching out with `interact`.
bonzai://nearbyThe closest people in the network right now, nearest first — context for connecting.