Getting StartedIntegrationEvent ReferenceAnalyticsAPI Reference

Analytics

TimeBack provides analytics infrastructure through QuickSight dashboards for visual analysis and an MCP server for AI-driven exploration. Both connect to the same curated analytics views containing student learning data, session patterns, and performance metrics.

Prerequisites

Before using analytics:

  1. Request access via email to timeback@trilogy.com
  2. Verify your credentials are configured for your environment (staging or production)

QuickSight for Visual Dashboards

AWS QuickSight provides pre-built and custom dashboards for exploring student data visually. You can create datasets by joining views from the analytics schema, build visualizations, and export dashboard snapshots.

Use QuickSight if:

  • You need visual exploration and charts
  • You're building reports for non-technical stakeholders
  • You want to share dashboards with your team

MCP for AI-Driven Exploration

The Model Context Protocol (MCP) server enables AI assistants to explore and query analytics data autonomously. LLMs can discover available entities, understand relationships, and execute SQL queries without human intervention.

Use MCP if:

  • You want AI assistants to explore data independently
  • You need LLMs to answer analytical questions with live data
  • You're building AI-powered analytics workflows

How it works: The MCP server connects to a simplified data model—curated SQL views built on top of TimeBack's internal database. These views expose clean entity relationships and match exactly what's available in QuickSight. Queries are limited to 500 rows and 25 seconds execution time.

Data Architecture

Both QuickSight and MCP query the same curated analytics views:

  • Student data: enrollments, mastery, XP
  • Session data: timing, duration, waste patterns
  • Content data: courses, lessons, tests, questions
  • Performance data: attempts, correctness, engagement

These views are built on top of TimeBack's internal database and expose clean entity relationships. See Analytical Entities for complete field documentation and join keys.

Related Docs

QuickSight Setup

Get access to QuickSight dashboards and learn about automated exports.

Analytical Entities

Complete catalog of all analytics entities with field definitions and join keys.

MCP Tools

Programmatic API for executing queries and fetching metadata.