> ## 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.

# Insights Overview

> AI-powered data queries and analytics

<Note>
  **Early Access** — Insights is currently available to select organizations. Reach out to your Sessionboard account manager to get early access to this feature.
</Note>

Sessionboard Insights lets you query your event data using **SbQL** (Sessionboard Query Language) or natural language. Build custom reports, explore session and speaker data, and power dashboards — all through the API.

<Info>
  The Insights API requires a token with the **read:insights** scope. See [Authentication](/authentication) for details on generating tokens with the correct scope.
</Info>

## Prerequisites

Two settings must be enabled to access Insights:

1. **Organization-level:** AI and Insights must be enabled for your organization. Contact your Sessionboard account manager to enable this.
2. **Token-level:** MCP Access must be turned on for your API token. This is configured when generating or editing a token alongside the `read:insights` scope.

## Capabilities

The Insights API supports the following operations:

| Capability           | Description                                                                                                            |
| -------------------- | ---------------------------------------------------------------------------------------------------------------------- |
| **Execute queries**  | Run SbQL queries directly against your event data and receive structured results.                                      |
| **Generate queries** | Convert natural language questions into SbQL using AI. Ask questions like "How many accepted sessions are in Track A?" |
| **Schema discovery** | Retrieve the available entities, fields, and relationships you can query — at the organization or event level.         |
| **Saved reports**    | List and execute saved queries (reports) that have been created in the Sessionboard dashboard.                         |
| **Dashboards**       | Retrieve dashboard configurations with all widget data.                                                                |
| **Suggestions**      | Get contextual query suggestions based on your data.                                                                   |

## Learn More

<CardGroup cols={2}>
  <Card title="SbQL Reference" icon="code" href="/insights/sbql">
    Learn the query language syntax, available entities, and example queries.
  </Card>

  <Card title="MCP Server" icon="robot" href="/insights/mcp-server">
    Connect AI assistants like Claude to your event data via Model Context Protocol.
  </Card>
</CardGroup>