MCP & AI Overview

The Model Context Protocol (MCP) is an open standard that lets AI assistants discover and interact with external services through a structured JSON-RPC interface. Attend-Go implements a fully functional MCP server, enabling tools like Claude Desktop and Cursor to read your attendance data, run analytics, create sessions, and mark attendance — all governed by the same rate limits, billing, and access controls as the web dashboard.

Attend-Go exposes a stateless JSON-RPC MCP endpoint at /api/mcp. It provides 12 tools (7 read + 5 write), 5 resources, and 4 prompt templates. Authentication uses the same API keys from the Integrations page — pass your key as a Bearer token. Read tools (ping, get_attendees, get_sessions, get_analytics, etc.) work with any key. Write tools (create_session, end_session, mark_attendance, update_attendee, delete_attendee) require keys generated with the 'write' scope enabled.

Read tools: ping — verify API key and org info. get_attendees — list attendees with sessions, rate, and last seen (supports filtering by session, date range, search, and sorting). get_attendance — attendance records with attendee names. get_sessions — list sessions with status and duration. get_analytics — full dashboard KPIs, 30-day trend, top attendees, weekday distribution. get_session_detail — single session with full attendance list. get_attendee_detail — attendee profile with attendance history. Write tools: create_session — start a new session. end_session — end an open session (triggers workflow automations). mark_attendance — mark attendee present by ID or name. update_attendee — update name, phone, or email. delete_attendee — remove attendee and their records.

MCP resources provide quick-access data snapshots: attendgo://org/info — organization name, plan, and counts. attendgo://sessions/recent — last 10 sessions. attendgo://attendees/enrolled — all enrolled attendees with stats. attendgo://analytics/kpis — dashboard KPI snapshot. attendgo://analytics/trend — 30-day attendance trend.

Pre-built prompts for common queries: attendance_summary — summarize attendance for a date. absent_report — list absent attendees for a session. session_recap — full session recap with duration and stats. weekly_digest — weekly summary with trends.

The MCP server enforces the same rules as the REST API and web dashboard: 120 requests per 60-second sliding window per API key per IP. All operations are scoped to your organization. Write operations require explicit 'write' scope on the API key.