# ClickBid MCP > ClickBid manages entire charity auction lifecycles right from your AI agent. You can instantly list all registered bidders, create new participants on the fly, track every monetary donation received, and manage the full catalog of items up for auction. It's the data layer you need to run complex event logistics without logging into a dashboard. ## Overview - **Category:** ecommerce - **Price:** Free - **Tags:** auction-management, charity-events, bidder-tracking, donation-management, event-logistics, fundraising ## Description This MCP connects your AI client directly to ClickBid’s core functions, letting your agent handle charity auctions as if it were sitting at the main desk. You tell your agent what needs doing—whether that's confirming a guest's registration details or pulling a list of all donations made so far. It handles the whole flow: listing available tickets, checking who purchased them, and making sure new auction packages are added to the catalog instantly. Because this functionality is hosted on Vinkius, you connect your preferred AI client once and gain access to this entire suite of event management tools. You never have to copy data between systems again; your agent just talks directly to the source of truth. ## Tools ### get_clickbid_item Pulls the full description and status of one specific auction item. ### list_clickbid_bidders Retrieves a complete list of every registered bidder for the event. ### list_clickbid_donations Lists all recorded monetary donations received during the auction period. ### list_clickbid_items Fetches a comprehensive list of every item currently available in the auction catalog. ### list_clickbid_ticket_purchasers Gets a report detailing all people who purchased event admission tickets. ### list_clickbid_tickets Shows the current inventory and list of available entry tickets for sale. ### create_clickbid_bidder Registers a brand new participant into the system's bidder database. ### create_clickbid_item Adds a completely new package or item to the auction catalog. ### get_clickbid_bidder Retrieves specific profile details for a known bidder using their ID. ### update_clickbid_bidder Modifies existing information, like contact details or status, for a registered bidder. ## Prompt Examples **Prompt:** ``` List all registered bidders for the upcoming auction. ``` **Response:** ``` Here is the information you requested based on the execution of the tools. ``` **Prompt:** ``` Retrieve the details for auction item ID 102. ``` **Response:** ``` Here is the information you requested based on the execution of the tools. ``` **Prompt:** ``` List all ticket purchasers so far. ``` **Response:** ``` Here is the information you requested based on the execution of the tools. ``` ## Capabilities ### Manage Participants Create new bidders or retrieve details for specific guests and check all registered users in one go. ### Handle Auction Inventory List the current catalog of items, get details on any piece, or add newly donated goods to the event list. ### Track Finances and Sales Pull a record of all donations made during the event and check out who purchased entry tickets. ## Use Cases ### The Event Coordinator needs a headcount It's 5 minutes before the auction starts and they need to know how many people bought tickets. Instead of calling the sales office, they just ask their agent to use list_clickbid_ticket_purchasers, getting an immediate, accurate count. ### The Donor Liaison needs to update a profile A major donor calls with updated corporate details. Instead of sending the info via email and hoping it gets logged, they ask their agent to use update_clickbid_bidder, ensuring the record is immediately corrected. ### The Development Team needs a new item entry A corporate sponsor just donated a $50k experience package. The developer asks the agent to run create_clickbid_item, adding it straight into the live auction catalog without manual data entry. ### The Board Treasurer needs a financial audit At the end of the night, the treasurer doesn't want to manually compile donation receipts. The agent runs list_clickbid_donations and returns an immediate, structured report for accounting. ## Benefits - Stop manually checking guest lists. You can use list_clickbid_bidders or get_clickbid_bidder to instantly verify any participant's details, which is critical during a high-traffic event. - Need to add last-minute donations? Use create_clickbid_item and list_clickbid_items to update the auction catalog without logging into a separate backend system. - Donor records are kept clean. You can use update_clickbid_bidder to correct spelling or change contact info, keeping your mailing lists accurate for future appeals. - See who's paying for entry. The list_clickbid_ticket_purchasers tool gives you a quick breakdown of ticket sales history when you need it most. - Keep track of the money coming in. By listing all donations via list_clickbid_donations, your agent provides an immediate financial snapshot to guide fundraising efforts. ## How It Works The bottom line is your AI client acts as a universal front-end to complex auction data, retrieving status updates without needing manual dashboard navigation. 1. Grab your API Key and Secret from the ClickBid Admin portal, then add those credentials to this MCP integration. 2. Instruct your AI agent with a natural language command, like 'List all bidders for tonight's event.' 3. The agent executes the necessary tool calls, pulls the required data (bidders, items, etc.), and returns it directly in plain text. ## Frequently Asked Questions **How do I get a list of every registered bidder using list_clickbid_bidders?** You simply instruct your agent to 'List all bidders.' The MCP executes the tool call and returns the full, current roster of participants. **Can I update a bidder's phone number with update_clickbid_bidder?** Yes. Just tell your agent which bidder ID to use and what the new information is. The tool handles modifying the record directly in ClickBid. **What if I need to add a donated item? Do I use create_clickbid_item?** That's right. Use create_clickbid_item and provide all the necessary details for the new package, making it immediately visible in the catalog. **How do I check who bought tickets using list_clickbid_ticket_purchasers?** Ask your agent to run list_clickbid_ticket_purchasers. It pulls a comprehensive record of every purchaser, so you know exactly who's attending. **When I use list_clickbid_donations, what specific details about each donation will my agent retrieve?** The tool pulls the donor's name, the monetary amount, and the date of the contribution. This gives you a clean record for tracking fundraising goals. **If I call get_clickbid_item with an auction item ID that doesn't exist, what should my agent do?** The system returns an error status code (like 404). Your AI client checks for this specific response and can then prompt the user to enter a valid Item ID. **When I run list_clickbid_tickets, does it tell me how many units of each ticket type are left?** Yes. The output includes inventory counts for every available ticket type. This is critical for knowing exactly what's in stock right now. **If I call list_clickbid_bidders repeatedly, should I be concerned about rate limits?** Yes, there are standard API rate limits. We advise your agent to pause briefly between large batches of calls to ensure consistent and smooth performance. **Can I add a new bidder straight from the chat interface?** Absolutely. By providing the 'create_clickbid_bidder' tool with a JSON string containing the guest's name and contact info, they will be registered instantly. **How do I retrieve a list of everyone who bought event tickets?** Use the 'list_clickbid_ticket_purchasers' tool. The AI will query the API and return the complete roster of ticket buyers for your active events. **Is it possible to view specific details about a donated item?** Yes. Provide the item's unique ID to the 'get_clickbid_item' tool, and the AI agent will pull its description, estimated value, and current bid status.