add_a_lot_via_webform
ChatGPTOpens the page for adding a lot, or several lots — a lot is an item for sale — with what they described already filled in, ready for them to check and save. Nothing is saved by calling this; the person saves it. Anything about adding, listing or selling lots is this, however many: 'add a lot', 'add lots to my next auction', 'list my guppies'. This is how a lot gets added here: the form matches the species, applies the auction's own rules and shows them what they are about to create. Pass everything they said; anything you leave out is just an empty box on the form. A lot is a thing — fish, plants, shrimp, food, equipment. If what they want to add is a PERSON ('add mike smith'), they mean add_person. Never look a lot up before calling this: a lot they are adding does not exist yet, and the page finds their own previous lot of the same name by itself. Examples: “add a lot of blue shrimp”; “sell my guppies”; “I want to list 3 java ferns”.
add_club_event
ChatGPTPut a meeting, swap, talk or workshop on a club's calendar. It reaches the club page, the club's iCal feed, Google Calendar and Discord in the same breath. Club admins only. Do NOT use this for an auction — an auction makes its own event. Examples: “put the october meeting on the calendar”; “add a swap meet on the 14th at 7”.
add_club_member
ChatGPTAdd a new member to a club. Club admins only. This is for club membership — someone joining the club itself. If they are being added to an AUCTION so they can bid today, that is add_person instead. Examples: “add jane doe as a new member”; “sign mike up for the club”.
add_donation_vendor
ChatGPTPut one business on a club's donation list: a shop to ask, or one that has already given something. Adding a row sends nothing — contact_donation_vendor does that. One business a call; there is no import. Club donation staff only. Examples: “add the corner pet shop to our donation list”; “add fishy business, they gave a gift card last year”.
add_dropdown_option
ChatGPTAdd one option to an auction's custom dropdown — the extra choice sellers pick from when adding a lot. Auction admins only. The dropdown stays switched off until it has a name and at least two options. Examples: “add 'Cichlid' to the dropdown”; “add a dropdown option for plants”.
add_invoice_adjustment
ChatGPTPut one extra line on somebody's invoice in an auction — a charge or a discount that isn't a lot: a raffle ticket, a membership taken at the door, money off for helping pack up. Whole dollars, and a negative amount is a discount. Auction admins only, and only while the invoice is still open. 'add $5 to Jane's invoice for the raffle', 'take $10 off bidder 14'. Examples: “add $5 to Jane's invoice for the raffle”; “take $10 off bidder 14 for volunteering”.
add_lot
ChatGPTAdd one lot — an item for sale — to an auction. Defaults to the user's most recent auction and to the user themselves as the seller. Only auction admins may pass 'bidder' to add a lot for someone else. A lot is a thing: fish, plants, shrimp, food, equipment. If what they want to add is a PERSON (a first name and a surname, 'add mike smith'), they mean add_person, not a lot called Mike Smith. If this seller has listed a lot of the same name before, that lot's description and photos are copied onto the new one — and its exact spelling of the name too, when the name given matches it exactly. The reply says so in 'reused_a_previous_lot'; tell the user, because edit_lot and remove_lot_image are how they undo it. Examples: “add a lot of blue shrimp”; “add 3 guppies for bidder 14”.
add_lot_image
ChatGPTPut a picture on a lot, from a link to the image. The seller or an auction admin only, up to six pictures per lot. This is what 'add a photo of this', 'find a picture of a blue dream shrimp for lot 12' and 'my lots need pictures' mean. Give the address of the image itself — one ending .jpg, .png or .webp — not the page it sits on. 'actual' means the seller photographed this exact item, and that is printed under the picture for bidders to read, so only use it for a photo the user says is their own. To find the lots that need one, use list_lots with without_images. Examples: “add a picture to lot 12”; “find photos for my lots that don't have any”.
add_lots
ChatGPTAdd SEVERAL lots to one auction at once. Use this whenever the user names more than one thing in a single sentence — 'add a java fern, a heater and three guppies' — and for several lots of the SAME thing, which is what 'count' is for: 'add 12 lots called fish for bidder 14' is one name with a count of 12, and comes out as 12 lots with 12 lot numbers and 12 labels. Each entry in 'lots' may be a plain name, or an object with a name plus any of the per-lot fields add_lot takes, plus its own 'count'. Anything set at the top level (bidder, donation, i_bred_this_fish, count) applies to every lot that doesn't set it itself. This is also the tool for a list somebody has read off a photograph or a sheet of paper: one call, one name per entry. Every lot goes through add_lot's rules, including reusing the description and photos from the seller's own last lot of that name — 'reused_a_previous_lot' on the reply says which ones did. Examples: “add a java fern, a heater and three guppies”; “add 12 lots called fish for bidder 14”; “add 5 donation lots under the club's bidder number”.
add_person
ChatGPTAdd a person to an auction so they can bid and sell. For auction admins and club staff only. This is what 'add mike smith' means: a person's name is a person, not a lot. Use check_in instead when they are already in the auction and are arriving. ONLY for a person with a name. 'add a lot', 'add lots', 'add some shrimp' are add_a_lot_via_webform, and 'name' here is never a whole sentence — if you cannot see a person's name in what they said, this is the wrong tool. Examples: “add mike smith”; “add a new bidder called Jane Doe”.
add_pickup_location
ChatGPTAdd a place where an auction's lots are collected. Auction admins only. An auction cannot be listed publicly until it has one, so this is often the missing piece when promoting an auction is refused. Examples: “add a pickup location at the club on Saturday”; “we're mailing lots this year”.
add_random_option
ChatGPTAdd one option to an auction's custom random field — a value each lot is given at random when it is added (A/B test groups, or which table a lot goes on), shown on the lot and its label. Nobody picks or edits it. Auction admins only. The field stays switched off until it has a name and at least two options; switching it on deals every lot already there. Examples: “add 'Table 3' to the random tables”; “add a B group to the random field”.
add_species
ChatGPTAdd a species to the list that genuinely isn't on it. For anyone who runs an auction. Try set_lot_species first and name_a_species second — the list is imported and has 36,000 fish in it. Three shapes: an ordinary species is a scientific name; a strain like 'Blue Dream' is a variety plus the species it is a strain of; a hybrid like 'Tibee' has no scientific name at all, so send hybrid=true and put the trade's name in variety. What somebody who isn't a site admin adds is suggested on their own lots and their club's until a site admin approves it for everyone. Examples: “add Ancistrus sp. L046 to the species list”; “add a hybrid called tibee”.
answer_question
ChatGPTReply to a question somebody has asked on one of the user's own lots. The reply is public on the lot's page, the same as typing it into the chat box there. Use my_messages first to see what was asked and on which lot. Only works on lots the user is selling. Examples: “tell them yes, they're captive bred”; “reply to the question on lot 42”.
auction_numbers
ChatGPTGet the running totals for an auction: how many lots there are, how many have sold, how many are still unsold, how many people have signed up and checked in, how long is left before it closes, and — for its admins — the gross, the median price and how many invoices are still unpaid. This is what answers 'how's it going?', 'how many have sold?', 'what's the gross?', 'how long is left?' and 'how many people are here?'.
auctions_near_me
ChatGPTList every auction the user is in — their clubs' own auctions included, at any distance and whether or not it is publicly listed — plus upcoming ones near them that they have not joined. This is the ONLY way to reach an auction they aren't already part of, so it is the right answer for 'is there an auction near me?', 'what's coming up?', 'what have I got on?', 'when's the next in-person one?'.
award_points
ChatGPTGive a club member breeder award points (BAP, and HAP or CAP where the club runs them separately). Club BAP admins only. 'give bob 10 points for the corydoras', '5 hap points for jane'. To explain how points are earned, use describe_club instead. Examples: “give bob 10 points for the corydoras”; “5 hap points for jane”.
cancel_volunteer_request
ChatGPTCancel a request for help and withdraw the notification that went out with it. Auction admins only. Examples: “we don't need the table carriers any more”.
change_email
ChatGPTChange this user's own email address. It does NOT take effect straight away: a confirmation link is sent to the new address and the change happens when they open it, so tell them to go and click it. Their mail keeps going to the old address until then. This is not their username, which is update_username. Examples: “change my email to ada@example.com”; “I've got a new email address”.
check_in
ChatGPTCheck a participant in to an in-person auction so they can bid. For auction admins and club staff only. Examples: “check in bob”; “check in bidder 22”.
club_api
ChatGPTThis club's own REST API, for writing an integration against it: which API keys exist, what each one is allowed to do, and the endpoint documentation with worked examples. Pass topic=members, points, species or auctions for the endpoints of that half — the whole thing does not fit in one answer. Read-only, and it cannot read a key's secret, which is shown once when the key is made and stored only as a hash. Nor can it create a key: it names the tick boxes and links to the page where a person makes one. Call it before writing any code against this site. If what the club wants is its events, its auction or its leaderboard on its own website, look at club_website_snippets first — those are embeds and need no key at all. Examples: “what API keys do we have?”; “write me something that posts our lots to our website”; “how do I add BAP points from our Google form?”; “can our WordPress plugin read the member list?”.
club_history
ChatGPTRead and search a club's change log — who did what to the club and when, newest first, and searchable back through the whole of it. Club staff only. This is the club-side half of recent_changes, and it holds what outlives any one auction: renewals and dues, members added, edited and merged, settings changed, breeder award points, announcements sent and retracted. It answers 'when did Bob last pay for his membership?', 'who changed the meeting night?' and 'did that announcement actually go out?'.
club_numbers
ChatGPTGet a club's own numbers: how many members it has, how many are paid up, how many lapse soon, and — for its treasurers — the book balance. This answers 'how many members do we have?', 'how many renewed?', 'what's our balance?'. Club staff only.
club_setup
ChatGPTWhat this site can do to help run a club, and which of it this club is already using. This is the answer to 'what can this site do for my club' and to 'is there anything we're not using' — pass show='unused' for the second, which is the more useful of the two. Each row says what the feature is for and how to switch it on. Read-only. Examples: “what can this site do to help run my club?”; “is there anything this site does that we're not using?”.
club_website_snippets
ChatGPTWhat a club can put on its OWN website: embeds for its events, past events, current auction, latest announcement and breeder award leaderboard, plus a calendar members can subscribe to. Each says whether it would show anything right now, and comes with the one-line script tag to paste. Read-only. Examples: “what can we put on our club website?”; “how do I show our events on our own site?”.
clubs_near_me
ChatGPTFind fish clubs near the user. This answers 'is there a fish club near me?', 'what clubs are around here?', 'who should I join?'.
contact_donation_vendor
ChatGPTEmail one donation vendor a message you wrote, and record it against them. The site adds the club's postal address, the unsubscribe link and a reply address that brings their answer back onto their row. A club set up to send its own donation mail gets the message filed to copy out instead of sent. Counts against the club's daily donation-email allowance, which every donation read reports. Club donation staff only. Examples: “ask the corner pet shop for a raffle donation”; “reply to fishy business about the gift card”.
create_auction
ChatGPTCreate a new auction by copying one this person has already run — next year's version of last year's auction. Every fee, rule, custom field and pickup location comes from the auction it copies; only the name and the start date are new. This is what 'set up the spring auction', 'create next month's auction' and 'make a copy of last year's auction for March 14th' mean. It cannot create a first auction from nothing — the answer says so and links to the page that can. The new auction is NOT listed publicly until it is promoted (update_auction_setting), and its dates are worth checking. Examples: “set up next year's spring auction for April 17th”; “copy last year's auction to March 14 2027”.
describe_auction
ChatGPTGet the full details of an auction: its dates, whether lot submission is open, its pickup locations, its fees and settings, and the full text of its rules. Use this to ANSWER questions about how an auction works — what the rules say, when things close, how much the club takes, how many lots there are.
describe_club
ChatGPTGet the full details of a club: what it is, what membership costs, and exactly how its breeder award (BAP/HAP/CAP) points are awarded, including the per-category overrides. Every point setting comes back with an explanation of what it does, so use this to ANSWER 'how do I earn points', not to guess.
describe_donation_vendor
ChatGPTRead one donation vendor: their status, their contact, what the club knows about them, and the emails to and from them with the newest first. This is what their last message actually said, which list_donation_vendors only summarizes in a line. It also returns the club's own donation details — its standing description, its postal address, and whether this site sends the mail or the club copies it out. Club donation staff only.
describe_lot
ChatGPTGet the full details of one lot: its description, category, prices, whether it sold and for how much. Use this to answer questions about a specific lot.
describe_person
ChatGPTGet everything about one participant in an auction: their bidder number, whether they've checked in, how many lots they brought, won and sold, and their invoice status. Auction admins only.
draw_door_prize
ChatGPTPick a door prize winner at random from the people who have checked in and haven't already won one. For auction admins and club staff. 'draw a door prize', 'pick a winner', 'who wins the door prize?'. Examples: “draw a door prize”; “pick a door prize winner”.
edit_lot
ChatGPTChange a lot that has already been added: its name, quantity, minimum bid, buy now price, whether it's a donation, its description, this auction's own custom fields, or a reference link. The seller or an auction admin only. This is what 'make lot 14 twenty dollars', 'change the shrimp to 3 of them' and 'that one's a donation' mean. Photos are add_lot_image. To find out about a lot instead of changing it, use describe_lot. Examples: “make lot 14 twenty dollars”; “change the quantity on the blue shrimp to 3”.
find_invoice
ChatGPTLook at one person's invoice in an auction: what they owe or are owed, whether it has been settled, the extra lines on it, and a link to it. With no 'person' it is the user's own; auction admins can name anybody in the auction. 'what does bidder 14 owe?', 'show me Jane's invoice', 'what do I owe?'. Examples: “what does bidder 14 owe?”; “show me Jane's invoice”; “what do I owe?”.
find_lot
ChatGPTLook up a lot by its number or name, in auctions this user is part of. Use this to turn 'the blue shrimp' into a lot number before acting on it.
find_page
ChatGPTSearch the list of pages when you aren't sure which destination key to use. Returns keys you can pass straight to go_to_page.
find_person
ChatGPTLook up a person among the club members and auction participants this user administers. Use this to turn a name into a bidder number before another action.
go_to_page
ChatGPTOpen any page on the site, and return its URL. 'page' is a destination key, or the page named in plain words — find_page searches the keys and returns ones that can be passed straight back here. Between them they reach every page this site has. Use 'target' when the page is about a particular thing: an auction name, a bidder, a lot, a club. This is the right answer for anything phrased as 'take me to', 'open', 'show me' or 'where is', and it is also the correct last resort when no other action fits. Examples: “take me to my invoice”; “auction rules”; “open the treasurer report”.
hide_category
ChatGPTHide a category's lots from the user's own lot lists, or show them again. Any signed-in user. 'I don't keep saltwater, hide corals', 'show me plants again'. Examples: “hide corals”; “stop hiding plants”.
hide_chat_message
ChatGPTHide a chat message somebody posted on a lot, or put a hidden one back. Auction admins only. The message is named by a few words out of it; more than one match comes back as a question. Use describe_lot to read what is on a lot. Examples: “hide that message on lot 14”; “put the hidden message on lot 3 back”.
join_auction
ChatGPTSign the user up for an auction, or say whether they're already in it. This is the ONLY action that can reach an auction the user has not already joined, so use it for 'sign me up for the fall auction', 'join the spring auction', 'am I registered for this one?'. Call it once WITHOUT agree_to_rules to get that auction's rules and its pickup locations, read them to the user, and call it again with agree_to_rules=true. It only ever signs up the person asking. Examples: “sign me up for the fall auction”; “am I registered for this auction?”.
leave_feedback
ChatGPTLeave feedback on a lot, as the person who bought it or the person who sold it. Anybody, on their own lots. 'the guppies were great', 'leave positive feedback on lot 9'. Which side the caller is on is read off the lot rather than asked; somebody who neither bought nor sold it is refused. Examples: “leave positive feedback on lot 9”; “the fish arrived dead, negative feedback on lot 12”.
list_club_events
ChatGPTA club's calendar: meetings, swaps, talks, and the events its auctions generate. This answers 'when's the next meeting?', 'what have we got on this autumn?' and 'what did we do in March?'. Examples: “when's the next meeting”; “what's on at the club this autumn”.
list_club_members
ChatGPTList a club's members by name, filtered by whether their dues are current. This is how to answer 'who has lapsed?', 'who is about to expire?', 'who renewed?' — club_numbers only counts them. The names it returns are what renew_member, update_club_member and award_points take. Club staff only.
list_donation_vendors
ChatGPTList the businesses a club is asking to donate something to a raffle or charity auction, and where each conversation has got to. Most overdue first, so status='due' is the club's work queue: who hasn't replied and is owed a nudge. Also answers 'who promised us something?', 'who said no?', 'what did they say?'. Club donation staff only.
list_lots
ChatGPTList the lots in an auction matching one status: 'unsold' (no winner yet), 'sold', 'mine' (the user's own lots), 'donations', or 'all', optionally narrowed to a search term. This answers 'which lots haven't sold?', 'did my lots sell?', 'what's left?' and — with 'query' — 'show me the unsold daphnia'. If they want to SEE and browse lots matching a search term, use search_lots instead. Examples: “which lots haven't sold?”; “show me the remaining daphnia”; “what's left?”.
list_people
ChatGPTList the people in an auction matching one status. Auction admins only. This answers 'who hasn't paid?', 'who hasn't checked in?', 'who's here?' and 'did I add anyone twice?'. To look up ONE person use describe_person instead.
list_pickup_locations
ChatGPTWhere an auction's lots are collected, and when. Anyone who can see the auction — 'where do I pick up my lots' is a bidder's question, not an admin's. Examples: “where do I pick up my lots?”; “what are the pickup locations?”.
lot_queue
ChatGPTGet the lot queue for an in-person auction: which lot is being sold right now and what is coming up behind it. Anybody in the auction can read it, not only admins. This answers 'what lot are we on?', 'what's next?', 'is anything I'm watching coming up?' and — with 'query' — 'are there any ancistrus selling soon?'. Examples: “what lot are we on?”; “any ancistrus selling soon?”.
my_activity
ChatGPTGet what THIS user has going on in an auction: their bidder number, how many lots they brought, how many sold, how many they won, what their invoice says, what they're watching — plus their club memberships, whether their dues are paid up, when they expire and how many breeder award points they have. Use this for anything phrased as 'what did I win', 'what do I owe', 'did my lots sell', 'am I paid up', 'how many points do I have', 'what am I watching'.
my_bidder_number
ChatGPTThe signed-in user's OWN bidder number in one auction, and whether they have checked in yet. About themselves only -- describe_person is the tool for somebody else, and is admin-only. "what's my bidder number", "what number am I bidding under", "am I checked in yet?". Examples: “what's my bidder number”; “what number am I bidding under at the fall auction”; “am I checked in yet?”.
my_context
ChatGPTWho the user is and what they're working on right now: every auction they're in and whether they run it, their clubs and memberships, and their most recent auction. Call this FIRST if you don't already know which auction or club they mean — it is the only tool that lists the auctions they're part of. Examples: “which auctions am I in”; “what am I working on”; “which clubs am I in”.
my_membership
ChatGPTShow the user their OWN club membership card: their membership number and its barcode, when the membership runs out, and whether it needs renewing. Read-only, and about the signed-in user only — it cannot be asked about anybody else. 'show me my membership card', 'am I still a member?', 'when does my membership expire?'. Examples: “show me my membership card”; “when does my membership expire?”.
my_messages
ChatGPTGet the questions people have asked on the user's own lots, newest first. This answers 'has anyone asked me anything?', 'any questions on my lots?', 'did anyone comment?'. Use answer_question to reply to one.
my_points
ChatGPTThe user's OWN breeder award points: how many they have at each of their clubs, and what an auction would add if all their lots sell and the club approves them. 'how many points do I have', 'how many points will I get this auction'. This is the member's side; points_queue is the club's. Examples: “how many points do I have”; “how many points will I get this auction if all my lots sell”.
name_a_species
ChatGPTTeach the site a name people actually type for a species that is ALREADY on the list — 'yellow lab' for Labidochromis caeruleus, which FishBase files under 'Blue streak hap'. For anyone who runs an auction. This is the right answer far more often than add_species: the list has 36,000 fish in it and the reason a name doesn't match is usually the name. Give the species' scientific name and the name people type. Pass a lot as well and it gets that species too. A name that already belongs to a different species is refused, because one name on two species means neither can be found by it. Examples: “yellow lab means Labidochromis caeruleus”; “teach it that this lot name is a bristlenose”.
no_sale
ChatGPTRecord that a lot did NOT sell in an in-person auction, ending it with no winner. Auction admins only. This is what 'pass', 'no sale', 'lot 14 didn't sell' and 'nobody wanted it' mean. It is the ordinary outcome for a lot, not an undo — to reverse a sale that was recorded wrongly, use undo_sale. Examples: “lot 14 didn't sell”; “pass on lot 22”; “no sale”.
place_bid
ChatGPTBid on a lot as the signed-in user, through the same code the bid box on the lot page uses — the same permission checks, the same proxy bidding, and the same live update for everybody watching. A bid cannot be withdrawn once it is placed, and the site offers no way to take one back. 'bid $20 on lot 14', 'bid 35 on the halfmoon betta'. Examples: “bid $20 on lot 14”; “bid 35 on that betta”.
points_queue
ChatGPTThe club's breeder award review desk: which lots are waiting for a points decision, which have been approved, which were denied, and which the seller never marked as bred at all. Club BAP admins only. Every row says what the site thinks the lot is worth and, when it thinks the lot earns nothing, why. Use review_points to decide one. For the rules themselves use describe_club. Examples: “show me the points I need to approve”; “which lots were denied last auction”; “show me lots that should have been marked bap but weren't”.
price_history
ChatGPTWhat one thing has sold for before, out of the auctions this user is part of. This is 'what does daphnia usually go for?', 'list the sale prices of this in past auctions' and 'what did these go for last time?'. The answer is the individual sales — price, quantity, which auction, when — with the low, the median and the high over all of them. A lot number is read as the lot in front of them, and the search is then done on that lot's species where it has one, so a lot called 'Water fleas' still matches every Daphnia sold before. Prices come only from auctions this user created, joined or helps run: it is their own club's price history, not the site's. Examples: “what does daphnia usually go for?”; “list the sale prices of this in past auctions”; “what did blue dream shrimp sell for last year?”.
print_labels
ChatGPTOpen a label printing page. Never prints by itself. Pass lot_id to print one specific lot's label (use the lot_id from an earlier add_lot in this conversation). Examples: “print my labels”; “print that label”; “print bidder 14's labels”.
queue_lot
ChatGPTPut one lot on the end of an in-person auction's running order, so the auctioneer gets to it next. Auction admins only. 'queue up lot 40', 'add 12 to the queue'. Use lot_queue to read the running order and unqueue_lot to take one back off. There is no way to reorder the queue from here — that is the queue page. Examples: “queue up lot 40”; “add lot 12 to the queue”.
read_source
ChatGPTRead this website's own source code, which is published as a public repository. It can search the code line by line, list a directory, read a numbered page of one file, or find a file by name. For when somebody asks how a feature is actually implemented, why the site behaved the way it did, or to see the code — 'how does it decide which lots earn breeder points?', 'show me the check-in code', 'why did my lot not get a species?'. Ordinary questions about auctions, lots, clubs and invoices are answered by the other tools and by search_help, which reads the help this site has written for people; this one is the implementation, and reaches out to the repository to get it. Examples: “how does the lot recommendation system work”; “how does the site decide which lots are eligible for breeder points”; “show me the code behind check-in mode”.
recent_changes
ChatGPTRead and search an auction's change log — who did what and when, newest first, and searchable back through the whole of it. Auction admins only. It answers 'what did you just do?' and 'what has changed today?', and with 'search' it answers questions about one thing: 'did we send an invoice email to Joe?', 'who marked lot 14 sold?', 'who checked Bob in?', 'when did that bidder number change?'.
record_club_money
ChatGPTWrite one line in a club's own books: money in or money out. Club treasurers only. 'put $40 in for the raffle prizes', 'record the speaker's travel'. Nothing is charged or paid — this is bookkeeping. The categories that are worked out from invoices cannot be entered by hand, and the answer names the ones that can. Examples: “put $40 in the books for raffle prizes”; “record -120 for hall hire”.
record_donation_contact
ChatGPTWrite down that somebody asked a donation vendor whose requests don't go by email — filled in the form on their own site, phoned them, or asked at the counter. This site can't do any of those, so this is the record that it happened: it moves the vendor to 'initial email sent' and starts the follow-up clock, and it spends none of the club's daily email allowance. Club donation staff only. Examples: “I submitted petco's donation form”; “called the corner pet shop about the raffle”.
refund_lot
ChatGPTRefund a lot that has sold, in an auction this user administers. There are two ways to pay for it and 'paid_by' picks which. The default, 'seller', is this site's ordinary refund: a percentage comes off the buyer's invoice and off the seller's payout together, so the club's commission drops by the same share — the Remove/refund button on the lot, and it sends the money back to the card where the sale went through Square. 'club' is the goodwill refund a club gives when it doesn't want the seller out of pocket: the buyer is made whole, the seller's payout is untouched, and the whole refund comes out of the club's cut as a discount line on the buyer's invoice, in whole dollars. Both leave the lot sold and neither deletes anything; a lot that should not have sold at all is undo_sale. Examples: “refund lot 14”; “refund this one out of the club's cut, not the seller's”; “give bidder 12 half their money back on lot 8”.
remove_award
ChatGPTTake back the breeder award points given for one lot, putting it back on the pending list with no decision on it. Club points admins only. This is the undo for review_points and the way a wrong call in a review session is fixed. Points that are not about a lot at all are removed on the club's points page. Examples: “undo the points on lot 14”; “take back the award for lot 3”.
remove_bid
ChatGPTRemove a bid from a lot: an admin can remove anybody's, and a bidder can take back their own where the auction allows it. This is the undo for place_bid. 'remove that bid', 'take bidder 14's bid off lot 9'. The lot's price goes back to whatever the next bid was. Examples: “remove my bid on lot 9”; “take bidder 14's bid off lot 22”.
remove_dropdown_option
ChatGPTTake one option off an auction's custom dropdown. Auction admins only. Examples: “remove 'Cichlid' from the dropdown”.
remove_invoice_adjustment
ChatGPTTake one extra line back off somebody's invoice — a charge or a discount that was put on it by mistake. Auction admins only. This is the undo for add_invoice_adjustment. The line is named by what it says, so 'take the raffle line off Jane's invoice'; more than one match comes back as a question. The invoice has to still be open. Examples: “take the raffle line off Jane's invoice”; “remove the $5 discount from bidder 14”.
remove_lot
ChatGPTDelete a lot, or take a standalone lot off sale so it can be put back later. Only the person selling it. This is the undo for add_lot and add_lots: 'delete lot 19', 'take my java fern lot down', 'that lot was a mistake'. A lot in an auction is deleted outright, and the auction's own rules decide whether that is still allowed; a lot not in any auction is deactivated instead, which removes its bids and is reversible with restore. Examples: “delete lot 19”; “take my shrimp lot off sale”; “put lot 4 back on sale”.
remove_lot_image
ChatGPTTake a picture off a lot. The seller or an auction admin only. This is 'remove that photo', 'that's the wrong fish, take it off' and undoing add_lot_image. A lot with more than one picture needs image_id, which describe_lot lists. Examples: “remove the picture from lot 12”; “take that photo off”.
remove_person
ChatGPTTake somebody out of an auction they were added to by mistake. Auction admins only. This is the undo for add_person, and it is deliberately narrow: a participant who has an invoice, lots to sell or lots they won is refused, because removing them would change those too. Merging a duplicate into the real record is done on the auction's user list. Examples: “remove bidder 51, I added them twice”; “take Jane out of the auction”.
remove_random_option
ChatGPTTake one option off an auction's custom random field. Lots that were given it are dealt one of the remaining options. Auction admins only. Examples: “remove 'Table 3' from the random field”.
rename_dropdown_option
ChatGPTRename one option on an auction's custom dropdown. Lots that already picked the old name keep it. Auction admins only. Examples: “rename the dropdown option 'Cichlid' to 'Cichlids'”.
rename_random_option
ChatGPTRename one option on an auction's custom random field. Every lot that was given it gets the new name. Auction admins only. Examples: “rename random option 'Table 3' to 'Back table'”.
renew_member
ChatGPTRenew SOMEONE ELSE's club membership, extending it by one period and recording the payment in the club's books. Club admins only. 'renew bob's membership', 'bob paid his dues'. For the user's OWN membership use renew_membership, which takes them to the page where they can pay. Examples: “renew bob's membership”; “mike paid his dues”.
renew_membership
ChatGPTOpen the membership payment page for one of the user's clubs. This never takes payment — it only takes the user to the page where they can pay. Examples: “renew my membership”.
request_a_skill
ChatGPTWrite down something this site should be able to do and can't — a tool here, or an endpoint on the club API an integration needed and didn't find. Call it when the user asked for something and nothing here can do it — after you have said so, not instead of saying so. It changes nothing and does not do the thing they wanted; it puts the request in front of the person who builds these. Say what it would be called, what it would need to be told, and what the user was actually trying to do. Do not call it for something a tool here already does, and do not call it twice for the same thing in one conversation. Examples: “there's no way to do that here”; “ask them to add a way to refund an invoice”.
request_volunteers
ChatGPTAsk the people at an in-person auction for help with a job — it goes to the phones of everyone in the auction with the app. Auction admins only, in-person auctions only. A bounty is optional and is what the club will pay whoever helps. Examples: “ask for 2 people to help carry tables”; “we need a runner, $10”.
resend_member_card
ChatGPTEmail a club member a fresh link to their membership card. Club admins only. This is the admin version of send_membership_card, which only ever sends the caller their own. A member with no email address, or one marked do-not-contact, is reported rather than emailed. Examples: “send Jane her membership card again”; “resend Sam's card”.
retract_announcement
ChatGPTTake back one of the club's announcements, the most recent unless told which. If it hasn't gone out yet it never does; if it has, this deletes the Discord post and takes it off the website, and says honestly what is still out there. Needs the 'send announcements' permission. Examples: “retract that announcement”; “unsend the last announcement”.
review_points
ChatGPTApprove, deny, or un-decide the breeder award points on one lot. Club BAP admins only. Approving with no number gives what the club's own rules make the lot worth, in whichever of BAP, HAP or CAP it belongs to; give a number to override that. 'approve the points for lot 14', 'award 20 points for lot 3', 'deny lot 9'. Undo puts the lot back on the pending list with no decision on it. Use points_queue to find the lots, and award_points for points that aren't about a lot at all. Examples: “approve the points for lot 14”; “award 20 points for lot 3”; “deny points for lot 9”.
rotate_lot_image
ChatGPTTurn a lot's photo the right way up, and pick which picture is its thumbnail. Only the person selling it. Useful for a client that can see the picture: describe_lot gives the address of each one, and this turns the sideways one. Adding and removing pictures are add_lot_image and remove_lot_image. Examples: “turn the photo on lot 14 the right way up”; “make the second picture on lot 3 the thumbnail”.
search_help
ChatGPTSearch this site's own FAQ and blog for how something works, or read the whole FAQ with no query at all. Use this for ANY platform question — 'how does proxy bidding work?', 'what's a donation lot?', 'how do I print labels?', 'what does buy now mean?'. This site does not work the same way as other auction sites, so answer from what this returns and not from general knowledge. If it finds nothing, say so. It also carries the answers that are kept off the public FAQ page for assistants to answer out of; those come back with no link, because there is no page to send anybody to.
search_lots
ChatGPTShow the user lots matching what they're looking for, by opening the lot list filtered to their search. This is the right answer for 'find shrimp', 'what plants are in this auction', 'any cichlids?' — anything where they want to SEE lots. Do not use find_lot for this; find_lot is for turning a name into a lot number before acting on it. Examples: “find shrimp in this auction”; “show me the plants”; “any pleco lots?”.
send_club_announcement
ChatGPTSay one thing to everybody in a club, in as many places at once as the club has set up: Discord, push notifications, its mailing list, its own website. Needs the 'send announcements' permission. It does NOT go out immediately — there is a short window to retract it. Examples: “tell the club the meeting moved to the 21st”; “announce the swap on discord and email”.
send_membership_card
ChatGPTEmail a club membership card to the address already on that membership. With no 'person' it sends the user their own card — 'send me my membership card', 'I lost my card'. Club staff can name another member to send them theirs — 'resend Jane's membership card'. The address is never taken from the request. Examples: “send me my membership card again”; “resend Jane's membership card”.
set_current_auction
ChatGPTPin which auction a club's page, website snippets and calendar links point at. Club admins only. Useful when two auctions overlap — last month's pickups and next month's entries. Examples: “make the spring auction our current one”.
set_invoice_renewal
ChatGPTSay whether somebody's invoice includes their club membership renewal. Admins only. 'Jane's renewing this year, put it on her invoice.' Turning it on also applies the club member discount and, where the club uses one, the alternate split — so the answer gives the new total. Examples: “Jane's renewing, put it on her invoice”; “take the renewal off bidder 14's invoice”.
set_invoice_status
ChatGPTMark one person's invoice in an auction as paid, ready, or open again. Auction admins only. This is the checkout desk: 'bob paid', 'mark bidder 14 paid', 'reopen jane's invoice'. It records that money changed hands — it does not take a payment. Examples: “bidder 14 paid”; “mark bob's invoice paid”.
set_lot_species
ChatGPTPut the scientific name on a lot, matched against this site's own species list. The seller or an auction admin only. This is what 'fix the scientific name on lot 10', 'lot 12 is Neocaridina davidi' and 'what species is this lot?' mean. Leave 'species' out to re-read it off the lot's own name, which is the fix for a lot added by a route that filled nothing in. A name matching several species comes back as a question with the candidates rather than a guess: a wrong species reaches a printed label and breeder points. If nothing matches, the species is usually on the list under a name nobody says — try name_a_species before add_species. Examples: “fix the scientific name on lot 10”; “lot 12 is a blue dream shrimp”.
set_lot_winner
ChatGPTRecord the winner and selling price of a lot in an in-person auction. Auction admins only. Needs the lot number, the winning bidder number, and the price. Examples: “lot 101 sold to bidder 14 for 25”.
set_member_active
ChatGPTDeactivate a club member, or bring a deactivated one back. Club admins only. Deactivating is a soft delete — nothing is destroyed and it can be undone by calling this again. 'retire Jane from the club', 'reactivate Sam'. Permanently deleting a member, and merging two of them, are still done on the club's member page. Examples: “deactivate Jane in the club”; “bring Sam back as a member”.
set_my_auction
ChatGPTSet which auction this user means when they don't name one, for everything after this. 'we're working on the spring auction', 'switch to tonight's auction', 'make this my current auction'. Only an auction they created, joined or run through a club. With no auction named it picks whichever of theirs is running now. my_context lists them and says which one is currently set. Examples: “work on the spring auction from now on”; “make tonight's auction my current one”.
set_my_club
ChatGPTSet which club this user means when they don't name one, for everything after this, and record it as their club affiliation on their account. 'I'm with the Betta Society', 'make this my club'. Only a club they belong to or help run. The affiliation is what a new auction they create gets filed under, so this is two changes and the answer says which ones it made. Examples: “I'm with the Betta Society”; “make the koi club my club”.
set_point_rule
ChatGPTSet what a genus or a category is worth in a club's breeder award program. Club points admins only. 'Corydoras are worth 15 points', 'make cichlids 10'. Calling it again with a different number replaces the rule. A genus rule outranks a category rule wherever both apply, and the answer says which one was written. Examples: “Corydoras are worth 15 points at our club”; “make cichlids 10 points”.
suggest_starting_prices
ChatGPTSuggest an opening bid for the lots in an auction that nobody has priced — the ones still sitting at the auction's own minimum bid, which is what the add-lot form fills in when the seller doesn't touch the field. For auction admins, and it is what an auctioneer means by 'what should I start these at?'. Each row carries the lot, the minimum bid on it now, what the same thing has gone for in this club's past auctions, and a suggested opening price worked out from those sales: the lower quarter of what it has sold for, rounded down, and not below the auction's minimum. A lot with nothing comparable behind it gets no number and says so instead of a guess. Nothing is changed — edit_lot is what sets a minimum bid. Examples: “what should I start these at?”; “suggest opening prices for the lots nobody priced”; “what should lot 14 open at?”.
undo_check_in
ChatGPTUn-check-in ONE person who was checked in by mistake — the reversal of check_in, and what 'undo that' runs after a misheard name. To clear a whole auction, call list_people with status='checked_in' and then call this once per person. For auction admins and club staff only. Examples: “undo bob's check in”; “bidder 22 isn't here after all”.
undo_last
ChatGPTReverse the last thing you did for this user, if it can be reversed. Use this for a bare 'undo that', 'no wait', 'that was wrong', 'never mind' — anything that refers back to the previous command without saying what it was. If they name what to undo ('undo lot 14'), use the specific action instead. Adding things cannot be undone this way, because that would mean deleting them. Examples: “undo that”; “no wait, that was wrong”; “never mind”.
undo_sale
ChatGPTClear the winner and price on a lot that was sold by mistake in an in-person auction, putting it back up for sale. Auction admins only. Examples: “undo lot 14”; “that last one was wrong, unsell it”.
unqueue_lot
ChatGPTTake one lot back out of an in-person auction's running order. Auction admins only. 'drop lot 42, the seller pulled it', 'take 7 out of the queue'. The lot itself is untouched — it is still in the auction and can be queued again. Examples: “drop lot 42 from the queue”; “take 7 out of the running order”.
update_auction_setting
ChatGPTChange one of an auction's settings by name — whether it is listed publicly, the minimum bid, the club's cut, how many lots each person may bring, whether buy now is allowed. Auction admins only. Dates and the rules text are not changeable here; send the user to the auction's edit page for those. To read the settings instead, use describe_auction. Examples: “list this auction publicly”; “stop promoting this auction”; “set the minimum bid to 2”.
update_club_event
ChatGPTMove, rename or call off something on a club's calendar. Club admins only. An event generated by an auction only takes a new title and description — its dates belong to the auction. Examples: “move the meeting to the 21st”; “cancel saturday's swap”.
update_club_member
ChatGPTChange a club member's details: email, phone number, address, membership number, the spelling of their name, or the admin note on them. Club admins only. Use 'person' for who to change and 'new_name' when the change is to their name. Examples: “change jane's email in the club to jane@example.com”.
update_club_setting
ChatGPTChange one of a club's settings by name. This reaches all four of a club's settings pages: its details (name, homepage, description, whether members can join themselves), membership (dues, renewal system, member barcodes), email (the welcome, renewal and expiring-soon messages, and who club mail goes to) and the breeder award program (points per lot, minimum quantity, which lots qualify). Each page has its own permission and the user needs the right one. To read the settings instead, use describe_club; to find out what a club could be using and isn't, use club_setup. Examples: “turn on the breeder award program”; “set our homepage to example.org”.
update_contact_info
ChatGPTChange this user's own name, phone number, mailing address, ship-to region or map marker — the contact info page. Their name and address are also held by every auction they have joined in the last month and every club they belong to, and this corrects all of them together. It will NOT work out a map marker from an address: pass location_coordinates as 'latitude,longitude' only if the user gives coordinates or confirms a place, because the marker decides which nearby auctions they are told about. Examples: “my new address is 12 Mill Lane”; “change my phone number”; “my last name is now Okafor”.
update_donation_vendor
ChatGPTChange one donation vendor: their status, email, contact name, the notes on them, or when to chase them again. Recording that a donation actually arrived is this — 'received' is the one status nothing infers from an email, because somebody has to have the thing in their hands. Club donation staff only. Examples: “the corner pet shop dropped off a gift card”; “mark fishy business not interested”; “petco only takes requests through their website”.
update_label_fields
ChatGPTChoose what gets printed on an auction's lot labels — the QR code, the lot name, the minimum bid, the seller's name, a custom field. Auction admins only. Called with no field named it reports what the labels print now, which is how to answer 'what's on our labels'. This is the AUCTION's label layout; a user's own printer and label sheet are update_printing_preferences. Examples: “what's on our labels?”; “put the seller's name on the labels”; “stop printing the QR code”.
update_person
ChatGPTChange something about a person in an auction: their email, phone number, address, the spelling of their name, their bidder number, the admin note on them, or whether they are allowed to bid or sell. For auction admins and club staff only. This is what 'change bob's email to bob@example.com', 'bob is bidder 12 now', 'let jane bid', 'stop bob selling' and 'note that bob paid cash' all mean. Use 'person' for who to change and 'new_name' (not 'name') when the change is to their name. This does NOT check anybody in, and it never makes anyone an admin. Examples: “change bob's email to bob@example.com”; “let jane bid”; “note that bob paid cash”.
update_pickup_location
ChatGPTChange ONE thing about a pickup location — its address, its time, its directions. Auction admins only. People have already chosen a location on their way into the auction, so large changes are worth saying out loud before making. Examples: “move pickup to 11am”; “change the pickup address”.
update_preferences
ChatGPTChange ONE of this user's own preferences without sending them to the preferences page: whether their email or username is visible, miles or kilometres, their currency, and every notification email they can turn on or off. 'stop emailing me about new auctions', 'switch me to kilometres', 'hide my email', 'turn on push notifications'. Say the setting in the user's own words — it gets matched against the real settings. One setting per call. Examples: “stop emailing me about new auctions”; “switch me to kilometres”; “hide my email address”.
update_printing_preferences
ChatGPTChange ONE of this user's own label printing preferences: which label sheet or printer they use, how many labels to skip on a part-used sheet, and what goes on a label. This is the user's own printing setup — to change what an AUCTION prints on its labels, use update_label_fields instead. One setting per call. Examples: “I'm using Avery 5160 labels”; “skip the first 3 labels on the sheet”.
update_username
ChatGPTChange this user's own username — the name on their public page and in its address. Not their email address or their password, which are changed on their own pages (go_to_page 'change email', 'change password'). A username cannot contain an @ symbol and cannot be one somebody else already has. Examples: “change my username to riverbend”; “I want a different username”.
watch_lot
ChatGPTAdd a lot to the user's watch list, or take it off again. Any signed-in user, on any lot they can see. 'watch this', 'save that lot', 'stop watching the plecos'. Examples: “watch this lot”; “stop watching lot 12”.
