# AI Service Information for The Gist

# About
The Gist is a daily reading comprehension game API. This API allows AI assistants to manage gists (short reading passages with true/false questions) on behalf of authenticated users.

# MCP Server Discovery
MCP-Manifest: /.well-known/mcp.json
MCP-Version: 1.0.0

# AI Plugin Discovery (OpenAI, ChatGPT)
AI-Plugin-Manifest: /.well-known/ai-plugin.json

# API Documentation
OpenAPI-Spec: /api/docs
API-Version: 1.0.0
API-Base-URL: /api

# Authentication
Auth-Type: OAuth 2.0 Device Code Flow
Auth-Documentation: /ai#authentication
Device-Code-Endpoint: /api/auth/device/code
Token-Endpoint: /api/auth/device/token
Verification-UI: /auth/device/verify

# Capabilities
- List gists (with filters by date, category, publication status)
- Get gist details
- Create new gists
- Update existing gists
- Publish/unpublish gists
- Generate gists with AI (Claude)
- Role-based access control (admin, team_member)

# Categories
hot-take, tweet, literature, science, news, history, philosophy, pop-culture, business, sports, technology, health, travel, food, art

# Rate Limits
None currently implemented

# Integration Guide
Human-Readable-Guide: /ai
Developer-Docs: /api/docs

# Contact
Support: See website for contact information
Documentation: /ai
Status: Production

# Security
- OAuth 2.0 Device Code Flow
- Bearer token authentication
- Role-based access control
- Team isolation for team members
- Long-lived tokens (1 year expiry)

# Usage Examples
See: /ai#examples

# Last Updated
2026-05-25