# Bevy Community MCP > Bevy Community MCP connects your AI agent directly to Bevy's event platform. You can list all community events, search chapters by keyword, track attendance records for specific gatherings, and get real-time counts of activity across regions—all through natural conversation. ## Overview - **Category:** collaboration - **Price:** Free - **Tags:** community-building, event-planning, chapter-management, attendee-tracking, virtual-events ## Description You don't need to log into a separate dashboard or export a CSV just to get an overview of your community. This MCP connects your AI agent straight to Bevy Community data so you can manage all virtual and in-person events simply by talking to it. Need to know which chapters a user belongs to? Just ask. Want to find out how many events are scheduled for next month? It'll give you the count immediately. You run complex reporting queries—like finding attendees for an event or checking chapter status—all through your natural conversation flow, no manual data handling required. When you connect this MCP via Vinkius, your agent treats Bevy Community as just another source of truth, giving you instant insights without ever leaving your workspace. ## Tools ### get_chapter Retrieves specific details for a single community chapter. ### get_event_counts Counts and reports on total events, grouped by their status (e.g., upcoming or completed). ### get_event Gets the full details for one specific event. ### list_chapters Lists every community chapter registered in the system. ### list_event_attendees Retrieves a list of all people who attended an event when you specify its ID. ### list_event_types Shows the standard categories or types of events that can be run. ### list_events Lists all community events, giving you a general overview of what's coming up. ### list_user_chapters Finds and lists all the chapters that a specific user is currently part of. ### search_chapters Searches through the chapter list using keywords to find relevant communities quickly. ### search_events Finds events matching specific text or themes across the entire community calendar. ## Prompt Examples **Prompt:** ``` List all upcoming events in our community. ``` **Response:** ``` I've retrieved your upcoming events. You have 3 events scheduled: 'Dev Meetup London' (ID: ev_1), 'Spring Product Launch' (ID: ev_2), and 'Community Breakfast' (ID: ev_3). ``` **Prompt:** ``` Search for events matching 'SaaS'. ``` **Response:** ``` I found 2 events matching 'SaaS': 'SaaS Growth Workshop' (ID: ev_992) and 'Enterprise SaaS Summit' (ID: ev_995). Would you like to see the attendee list for either? ``` **Prompt:** ``` Show the count of completed events this month. ``` **Response:** ``` Retrieving event counts... This month, your community has successfully completed 12 events across 5 different chapters. ``` ## Capabilities ### Find and list events Retrieve a full list of all scheduled community events using keywords or date ranges. ### Search for specific chapters Locate regional groups or communities by entering simple text keywords. ### View event attendance lists Pull the names and details of every person who attended a single, specified gathering. ### Check chapter status and detail Get specific information about any known community chapter or group. ### Track event counts by status Instantly count events, separating them into groups like upcoming, completed, or canceled for quick reporting. ## Use Cases ### The quarterly report needs attendee numbers. A Community Manager needs to prove how many people attended the last three regional meetups. They ask their agent to use `list_event_attendees` for each event, compiling a single total list of unique users without opening five different dashboards. ### We need to find all our local chapters. A Developer Relations Lead is expanding into a new state and needs to know if any existing groups are active there. They use `search_chapters` with the location name, instantly generating a list of viable contacts. ### Is our event schedule accurate? An Event Organizer wants to check how many events are scheduled for Q3 and if any are marked as completed incorrectly. They run `get_event_counts` to get immediate, reliable metrics on status. ### User X needs onboarding help. A program coordinator wants to know where a new user is involved in the community. They use `list_user_chapters` to see every single group that user belongs to, allowing them to tailor the welcome message. ## Benefits - Get instant attendee lists: Instead of exporting a roster after an event, use the `list_event_attendees` tool to pull who showed up for any gathering you name. This saves minutes every time. - Monitor community health with counts: Use `get_event_counts` to get real-time summaries showing how many events are upcoming versus completed. No more manual spreadsheet updates needed. - Map out your user base: Need to know which groups a person belongs to? The `list_user_chapters` tool instantly shows all chapters associated with that user ID, helping you map out outreach efforts. - Find anything fast: Use `search_events` or `search_chapters` to find specific activities or groups by keyword. This is much faster than browsing through massive lists of results. - Get a full overview: The `list_events` tool gives you the complete, up-to-date schedule for all community events in one go. It's your single source of truth for planning. - Deep dive into groups: You can use `get_chapter` to pull granular details on any specific chapter, letting you understand its mission and scope without leaving your agent. ## How It Works The bottom line is that your AI agent manages the connection and executes the data retrieval in the background, so you just get a clean answer upfront. 1. Subscribe to this MCP and provide your Bevy Subdomain and API Token. 2. Connect the MCP to your preferred AI client (like Cursor or Claude). 3. Tell your agent what you need—for example, 'List all completed events from last quarter'—and it handles the rest. ## Frequently Asked Questions **How do I list all community events using the list_events tool?** Simply ask your agent to 'list all events.' The `list_events` tool will pull the entire schedule, giving you an immediate overview of every current and upcoming activity. **Can I find attendees for a specific event using list_event_attendees?** Yes. You provide the event ID to your agent, and it uses `list_event_attendees` to fetch the full roster of everyone who attended that single gathering. **What if I want to find an event by a keyword?** You don't need to use `search_events`. You can ask your agent to search for events using keywords, and the system will automatically route that request through the correct searching function. **Does get_event_counts track all types of activity?** No. The `get_event_counts` tool specifically tracks the count of events based on their status (like upcoming, completed), not overall user activity or attendance metrics. **How do I see which chapters a user belongs to? Use list_user_chapters.** To check a user's affiliations, you use `list_user_chapters`. You just give the agent the user ID, and it returns every chapter they are connected with. **How do I use the get_chapter tool to find detailed information about a single community group?** It pulls comprehensive details for one specific chapter, including its regional distribution and founding date. This lets you gather context that simple listing tools don't provide. **What does the list_event_types tool do if I need to know what kinds of events our community hosts?** This tool gives you a definitive list of available event categories or types. It helps ensure that when you plan an activity, it matches one of the recognized formats. **If I want to see all existing community groups, what information does list_chapters provide?** The command returns a structured list containing every chapter's name and unique ID. You can quickly map out your entire network of regional communities. **Can I see the list of attendees for a specific event?** Yes! Use the `list_event_attendees` tool with the Event ID. Your agent will fetch the full list of community members registered for that event. **How do I find community chapters in a specific region?** Simply ask the agent to `search_chapters` with the region name as a query. It will retrieve all matching community groups located in that area. **Does the integration allow me to update event details?** Currently, the toolset focuses on querying and monitoring (Read-Only). You can list and inspect events, attendees, and chapters, but creation or modification must be done through the Bevy HQ dashboard for security.