# Guidebook MCP

> Guidebook manages content for your mobile event app directly from any AI client. Use this MCP to automate data management, handling everything from listing all active guides and retrieving specific session details to coordinating speaker bios and managing custom lists like sponsors or exhibitors.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** mobile-apps, event-planning, schedule-management, content-delivery, attendee-engagement

## Description

This connector lets you manage the entire content lifecycle of a mobile event application without touching the Builder interface. Your agent talks to Guidebook, giving it read access across your whole catalog. You can ask your AI client to pull together all metadata for every guide in your account; then have it list out every session scheduled for one specific day. Need speaker details? It grabs those too. And if you need to check the roster of sponsors or exhibitors, it pulls that custom data right into your conversation flow. Since Vinkius hosts this MCP, connecting is simple: link your key and let your agent do the heavy lifting across all these resource types.

## Tools

### get_guide
Fetches detailed metadata for one specific mobile guide project.

### get_rate_limit
Checks your current API quota usage and remaining rate limits.

### get_session
Retrieves detailed information for a single, specific scheduled session.

### get_speaker
Fetches detailed profile data and bios for one speaker.

### list_custom_lists
Lists all items in custom groups, like exhibitors or sponsors, associated with a guide.

### list_guides
Provides an inventory of every active mobile guide available in your account.

### list_locations
Retrieves all defined venues and map locations for a given guide.

### list_schedules
Lists the overall schedule flow across an entire event guide.

### list_sessions
Gets a comprehensive list of all scheduled sessions for a specific guide.

### list_speakers
Lists every speaker or presenter registered for the event guide.

## Prompt Examples

**Prompt:** 
```
List all active mobile guides in my account.
```

**Response:** 
```
I've retrieved your guides. You have 3 active projects: 'Global Tech Summit 2024' (ID: 8821), 'Internal Sales Kickoff' (ID: 8825), and 'Partner Conference Q2' (ID: 8830). Which guide would you like to inspect?
```

**Prompt:** 
```
Show the schedule sessions for guide ID 8821.
```

**Response:** 
```
Fetching sessions for Guide 8821... I found 5 main sessions for today, including 'Opening Keynote' at 09:00 AM, 'Cloud Infrastructure Workshop' at 11:30 AM, and 'Networking Lunch' at 01:00 PM. Should I get more details on any of these?
```

**Prompt:** 
```
Who are the speakers for the Global Tech Summit?
```

**Response:** 
```
Accessing speakers for Guide 8821... I've identified 12 profiles, including Dr. Sarah Chen (AI Research), Marcus Viera (DevOps Lead), and Jane Doe (UX Design). Would you like to see a specific speaker's full bio?
```

## Capabilities

### List All Guides
Retrieves a complete inventory of every mobile guide project in your account.

### Get Guide Details
Pulls specific, deep metadata for one chosen guide project.

### Manage Schedules
Lists and inspects the event's overall schedule flow and timeline.

### Review Sessions
Retrieves detailed information for a single, specific scheduled session.

### Coordinate Speakers
Accesses detailed profiles and bio information for any registered presenter.

### Audit Custom Lists
Manages and retrieves data from specific custom lists, like sponsors or exhibitors.

### Find Locations
Gets a list of all defined venues and map locations used across your event guides.

## Use Cases

### Verifying Speaker Data Before Print
A marketing lead needs to confirm the full bio and title for 12 speakers across three different guides. They prompt their agent, which uses `list_speakers` first, then calls `get_speaker` multiple times to compile a single, verified list for their printing team.

### Building an Event Map
An app developer needs all the physical venues and locations used in the event. They prompt their agent, which uses `list_locations`. The resulting structured data is then fed into a map rendering API for development.

### Debugging Schedule Conflicts
The ops team finds two sessions listed for the same time slot. They ask their agent to use `list_schedules` and then `get_session` on both conflicting IDs, allowing them to see the details side-by-side in the chat window.

### Auditing Sponsor Inclusion
A content manager wants to ensure all 50 contracted sponsors are included and correctly listed. They use `list_custom_lists` to pull the full roster, instantly verifying inclusion against their master spreadsheet.

## Benefits

- Quickly verify session times and speaker assignments without clicking through the CMS. Use `list_sessions` or `get_speaker` to pull real-time data into your agent's memory.
- Stop manual content auditing. Running `list_custom_lists` lets you audit sponsors, exhibitors, or other custom groups instantly from a prompt.
- Build reliable front ends by letting the MCP handle structured reads. You can grab all location data with `list_locations` and feed it directly to your app's map view.
- Get an accurate project overview immediately using `list_guides`. Know exactly what guides you have available without navigating complex menus.
- Avoid API overages by checking usage first. The dedicated `get_rate_limit` tool lets you monitor your quota before running big data queries.

## How It Works

The bottom line is you talk to your agent, and your agent talks to Guidebook's data layer. You never have to write API calls or touch a dashboard.

1. First, subscribe to this MCP on Vinkius and enter your Guidebook API Key (JWT token).
2. Next, connect your preferred AI client; it handles the authentication handshake.
3. You simply prompt your agent with a natural language question, like 'What are the speakers for the Tech Summit?' The agent then calls the necessary tool to get the data.

## Frequently Asked Questions

**How do I generate my Guidebook API Key?**
Log in to Guidebook Builder, click your profile dropdown in the top right, select 'Manage your account', and then navigate to the 'API Key' section to generate your token.

**Can I see the schedules for multiple guides?**
Yes! You can use `list_guides` to find the IDs for all your guides, and then use `list_sessions` or `list_schedules` with the specific guide ID to see its agenda.

**How many requests can I make to the Guidebook API?**
The Guidebook Open API typically has a limit of 10,000 requests per day per account. You can use the `get_rate_limit` tool to check your current usage.

**What format should the API Key be in?**
The API Key should be the raw JWT token provided by the Guidebook Builder. The integration will automatically handle the 'JWT' prefix for authorization.

**What happens if I run `get_guide` with an invalid guide ID?**
The API returns a specific error code and detailed message explaining the failure. This prevents data errors; your agent knows exactly why the request failed, allowing it to prompt you for corrections instead of guessing.

**If I use `list_guides`, how do I retrieve results beyond the first page?**
The tool supports cursor-based pagination. When your agent gets a response, look for the next cursor token and include it in your subsequent call to pull all available guides efficiently.

**When using `get_speaker`, can I confirm if that speaker is linked to a specific schedule session?**
The API response for `get_speaker` includes an optional field listing associated sessions. This confirms the linkage, letting your agent build a complete profile view without needing multiple tool calls.

**What metadata does `list_custom_lists` return for content like sponsors or exhibitors?**
It returns structured records containing the custom list name, item ID, and core data points specific to that category. This lets your agent manage all non-standard content using a single command.