# Guidebook MCP > Guidebook MCP connects your AI agent directly to event guide data. Manage entire conference schedules, attendee lists, and venue maps through natural conversation. Quickly create new guides or update existing content without ever touching a complicated web builder. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** mobile-apps, event-scheduling, attendee-engagement, no-code, guide-management, conference-tools ## Description You can now manage complex mobile event guides using only conversation. Whether you’re planning a massive conference or an internal company kickoff, this MCP lets your AI agent act as your dedicated coordinator. You simply tell the system to check the current schedule for 'Global Tech Expo' and get back a clean list of sessions. Need to add 20 new speakers? Just ask the agent to update the custom list. This means you stop clicking through complex web builder menus, manually checking APIs, or hunting down specific data points across different tabs. It all happens in chat. Connecting this MCP via Vinkius gives your AI client full control over listing guides, mapping locations, and keeping every attendee updated automatically. ## Tools ### check_guidebook_status Verifies that your connection to the Guidebook service is active and working. ### create_custom_list_item Adds a specific item, like a new speaker or sponsor, to an existing custom list. ### create_guide Sets up and initializes an entirely new mobile event guide. ### get_event Retrieves the full details for a single, specific scheduled session or event. ### get_guide Pulls all metadata and high-level information about a specified guide. ### list_attendees Lists the names and details of every person registered for a particular event guide. ### list_custom_list_items Shows you all the current entries within a specific custom list (e.g., only listing speakers). ### list_custom_lists Retrieves a catalogue of all available custom lists, like 'Sponsors' or 'Keynote Speakers'. ### list_events Lists every scheduled session that has taken place or is planned for the guide. ### list_guides Provides a list of all mobile guides you have created in your account. ### list_locations Searches and lists all mapped venues or meeting locations used by the event. ### update_guide Modifies specific details, like changing a guide's title or description, after it has been created. ## Prompt Examples **Prompt:** ``` List all my mobile guides in Guidebook. ``` **Response:** ``` I've retrieved your mobile guides. You have 3 active guides: 'Global Tech Expo 2026' (ID: g_123), 'Internal Sales Kickoff' (ID: g_456), and 'Partner Summit' (ID: g_789). Which one would you like to inspect? ``` **Prompt:** ``` Show the schedule for the 'Global Tech Expo 2026' guide. ``` **Response:** ``` Fetching schedule for Global Tech Expo (ID: g_123)... I found 12 scheduled sessions. Notable highlights include 'AI in Industry' at 10 AM and the 'Cloud Keynote' at 2 PM. Would you like the location details for any of these? ``` **Prompt:** ``` List all speakers for the guide ID 'g_123'. ``` **Response:** ``` Scanning custom lists for 'g_123'... I've retrieved the speaker list. You have 25 speakers registered, including keynote presenters and technical leads. I can provide the full list or search for a specific name. ``` ## Capabilities ### Oversee the guide's structure Create entirely new event guides or retrieve metadata about existing ones to know what content is available. ### Manage conference schedules and sessions Get detailed session information, list all events for a specific guide, and update the entire program lineup. ### Organize related data lists Create, view, and populate custom lists of speakers, sponsors, or exhibitors to keep track of key people involved in the event. ### Track attendee presence and details List all registered attendees for a guide so you can monitor participation numbers. ### Map out physical locations Search and list specific venues or rooms needed for the event, ensuring everything is spatially coordinated. ## Use Cases ### The schedule changed last minute The conference coordinator asks, 'What's the updated program for tomorrow?' The agent runs `get_event` and `list_events`, pulling all changes and confirming that the keynote speaker is now in Ballroom B instead of the main hall. No manual calendar updates needed. ### Need to onboard a new client The onboarding lead asks, 'List all current training guides for new hires.' The agent runs `list_guides`, providing IDs and titles immediately so they can send the relevant materials without searching through folders. ### Marketing needs to add sponsors Instead of logging into a separate sponsor portal, the marketing manager asks the agent to 'Add TechCorp as a new sponsor.' The agent uses `create_custom_list_item` and updates the custom list automatically. ### Checking venue readiness An operations team member needs to know where all the breakout rooms are. They ask the agent, 'List all mapped locations for the summit.' The agent uses `list_locations` and provides a clean list of coordinates. ## Benefits - Stop updating guides piece by hand. Use the `update_guide` tool through chat to change titles, descriptions, or core details for any guide instantly. - Instantly get a full picture of what's happening. Running `list_events` lets you pull every session scheduled, so you never miss an important time slot. - Build out your content without manual effort. Use `create_guide` to spin up new event guides and immediately populate them with core metadata. - Keep track of who attended. The `list_attendees` tool pulls the full roster for any guide, letting you quickly audit participation numbers. - Organize your intellectual assets. You can use `create_custom_list_item` to add new speakers or sponsors and then list them all using `list_custom_list_items`. ## How It Works The bottom line is you talk to your AI client, and it handles the complex API work behind the scenes. 1. Subscribe to this MCP on Vinkius and retrieve your API Key from Guidebook Builder. 2. Connect your preferred AI client (like Cursor or Claude) using the key. The agent now has access to all event data. 3. Ask a natural language question, like 'Show me the speaker list for the Partner Summit,' and the MCP executes the necessary calls. ## Frequently Asked Questions **How do I use the list_guides tool?** You ask your agent to 'List my guides.' It retrieves a list of every mobile guide you've set up, giving you the ID and name needed for further actions. **Can I update schedules using the get_event tool?** No. The `get_event` tool only pulls details; it doesn't change them. To modify a session, you must use the `update_guide` tool via your agent. **What is the difference between list_events and get_event?** The `list_events` tool gives you an overview of all sessions. If you need deep details—like a speaker's bio or specific session materials—you use `get_event` on a single, known event. **Do I need to list_locations for my conference?** You should if your guides are mapping physical venues. The tool lets you search and pull accurate details about every room or area used during the event. **How do I use the `check_guidebook_status` tool?** This tool confirms if your connection to Guidebook is working. Running it verifies that your API key and credentials are correctly set up, giving you peace of mind before running larger data queries. **How do I use the `create_custom_list_item` tool?** You use this to add new records, like a speaker or exhibitor, directly into your custom lists. It's perfect for onboarding new data without manually editing the web builder. **When should I use the `update_guide` tool?** Use this when you need to make structural changes across an entire guide, not just a single session. It's your go-to for large-scale modifications that affect the overall scope of the mobile app. **How do I list all participants using the `list_attendees` tool?** This tool pulls a complete roster of every person registered in an active guide. You can then process this data to segment users or check attendance metrics quickly. **How do I find a Guide ID?** You can use the `list_guides` tool to retrieve all mobile guides in your account along with their unique identifiers and names. **Can I see the speakers or exhibitors for an event?** Yes! Use the `list_custom_lists` tool with a specific `guide_id` to retrieve all custom directories like speakers, exhibitors, or sponsors. **Does the integration support viewing the event map?** The `list_guide_locations` tool provides the metadata for all mapped locations within a guide, helping you identify precisely where sessions take place.