Skip to main content

Documentation Index

Fetch the complete documentation index at: https://apidocs.sessionboard.com/llms.txt

Use this file to discover all available pages before exploring further.

Early Access — The MCP Server is currently available to select organizations. Reach out to your Sessionboard account manager to get early access to this feature.
The Sessionboard MCP (Model Context Protocol) server allows AI assistants like Claude to query and manage your event data directly. Built on the Model Context Protocol standard by Anthropic, the MCP server exposes 27 consolidated tools covering read access, write operations, analytics, and agenda planning.

​
What is MCP?

Model Context Protocol is an open standard that enables AI assistants to securely connect to external data sources and tools. Instead of copying data into prompts, MCP lets the AI query and update your data on demand through a structured interface.

​
Prerequisites

Three things must be enabled before the MCP server will accept requests:
  1. AI must be enabled for your organization — Contact Sessionboard support or your account manager to enable AI features for your organization.
  2. MCP access must be enabled on your organization — This is a separate feature flag that grants access to the MCP and Insights endpoints.
  3. MCP must be enabled on your API token — When generating or editing an API token, ensure the MCP Access toggle is turned on and the read:insights scope is granted. For write operations, add the appropriate write scopes (e.g., write:sessions, write:contacts, write:events).
If any of these are missing, MCP requests will return a 403 Forbidden error.

​
Setup

1

Generate an API Token

Create an API token in the Sessionboard admin dashboard with the read:insights scope and MCP Access enabled. Add write scopes if you want the AI to create or update data. See Authentication for detailed instructions.
2

Configure Your AI Client

Add the Sessionboard MCP server to your AI client’s configuration. The exact setup depends on your client.Remote connection (Claude Desktop, Claude Code, ChatGPT, etc.):
{
  "mcpServers": {
    "sessionboard": {
      "url": "https://mcp.sessionboard.com/mcp"
    }
  }
}
When you connect, the MCP server will walk you through OAuth authorization automatically — no need to configure tokens manually.For EU-hosted organizations, use https://mcp-eu.sessionboard.com/mcp instead.
3

Start Querying

Ask your AI assistant questions about your event data in natural language. The assistant will use the MCP tools to query Sessionboard and return results.

​
Available Tools (27)

The MCP server exposes 27 tools organized into 3 categories. Write operations use a manage_* pattern — one tool per entity with an action parameter to pick the operation (e.g., action: "create"). All tools include MCP annotations for safe AI behavior — read tools are marked readOnlyHint: true, write tools are marked destructiveHint: false, and all are openWorldHint: false.

​
Search & Analytics (8 tools)

Find events, ask questions about your data, and explore your schema.
ToolDescription
list_eventsList all events in the organization
find_eventSearch events by name
get_event_overviewEvent summary — session counts, speakers, tracks, status breakdown
get_schemaBrowse your data model — entities, fields, and relationships
query_dataAsk a question in plain English and get results (AI writes the query for you)
execute_sbqlRun a SbQL query directly with pagination
get_suggestionsGet suggested queries based on your data
get_widget_schemaWidget types, configs, and grid layout rules for dashboards

​
Read Details (4 tools)

Fetch sessions and contacts. All read-only and paginated.
ToolDescription
list_sessionsList sessions for an event (paginated, up to 100 per page)
get_sessionGet a single session by ID with full details
list_contactsList contacts for an event (paginated, up to 100 per page)
get_contactGet a single contact by ID with full details

​
Create & Manage (15 tools)

Each manage_* tool handles all operations for an entity — create, update, delete, and more — using an action parameter. For example, manage_session with action: "create" creates a session, while action: "update" updates one.
ToolActionsScopeDescription
manage_metadatalist, create, updatewrite:metadata / write:fieldsRooms, tracks, tags, formats, levels, languages, statuses, and custom fields
manage_sessioncreate, update, restore, update_fieldswrite:sessionsSession CRUD + custom field values
manage_contactcreate, update, restorewrite:contactsContact CRUD (find-or-create by email)
manage_exhibitorcreate, update, restorewrite:exhibitorsExhibitor CRUD
manage_sponsorcreate, update, restorewrite:sponsorsSponsor CRUD
manage_agenda_draftlist, get, create, update, delete, get_changes, commitwrite:eventsAgenda draft lifecycle
manage_draft_sessionslist, create, update, delete, bulkwrite:eventsSession placements in drafts
manage_event_ruleslist, get, create, update, deletewrite:eventsScheduling rules and constraints
manage_personaslist, get, create, update, deletewrite:eventsEvaluation personas
manage_event_dashboardlist, get, create, update, deletewrite:eventsEvent-scoped dashboards
manage_event_widgetcreate, update, deletewrite:eventsEvent dashboard widgets
manage_event_reportlist, run, create, create_from_nl, update, deletewrite:eventsEvent-scoped saved reports
manage_org_dashboardlist, get, create, update, deletewrite:eventsOrg-level dashboards (cross-event)
manage_org_widgetcreate, update, deletewrite:eventsOrg-level dashboard widgets
manage_org_reportlist, run, create, create_from_nl, update, deletewrite:eventsOrg-level saved reports (cross-event)

​
Parameter Conventions

  • Event scoping — All event-scoped tools require event_id (snake_case string).
  • Action selection — Consolidated tools use action to pick the operation (e.g., action: "create").
  • Entity IDs — snake_case: session_id, contact_id, entity_id, draft_id, widget_id, query_id.
  • Optimistic concurrency — Update actions require updated_at (ISO 8601 timestamp from the last read). Returns 409 Conflict if the entity was modified since.

​
Result Size Safety

All results are automatically truncated to prevent context window overflow:
  • List results — Capped at 50 items. When truncated, the response includes truncated: true, total_count, and a hint with guidance on pagination.
  • Query results — Capped at 100 rows with truncation metadata.
  • SbQL queries — execute_sbql and query_data default to a 50-row limit. Use the limit parameter for more.

​
Resources

The MCP server also exposes two MCP resources that AI clients can load into context:
URIDescription
sbql://schemaThe SbQL schema — entities, fields, relationships, and format functions
sbql://eventsList of events in the organization with metadata

​
Prompt Templates

Pre-built templates that structure the AI’s approach to common report types:
PromptDescription
speaker_rosterGenerate a speaker roster with contact info and session assignments
session_scheduleGenerate a day-by-day session schedule grid
evaluation_summaryGenerate an evaluation/review score analysis
task_statusShow outstanding tasks across speakers and exhibitors

​
Security

  • Org isolation — The SbQL compiler injects org_id into every query from the authenticated token. Prompt injection cannot access other organizations’ data.
  • PII obfuscation — Enabled by default. Emails become j***@a***.com, phone numbers become ***-***-4567. Org admins can toggle this per-token.
  • Scoped access — Tokens are restricted to specific scopes and optionally to specific events.
  • Audit logging — Every API call is recorded with source, method, response time, and token ID.

​
Example Conversations

Once connected, you can ask questions like:
  • “How many sessions are accepted for this year’s conference?”
  • “Show me the top 10 speakers by number of sessions.”
  • “What’s the breakdown of sessions by track and status?”
  • “List all sessions that don’t have a room assigned yet.”
  • “Create a new track called ‘AI & Machine Learning’ with color #4F46E5.”
  • “Build a dashboard showing session counts by status and track.”
  • “Create a draft agenda and schedule the keynote in the Main Hall at 9am.”