# MyQuizGPT - AI-Powered Quiz & Flashcard Generator

**llms.txt File**: This file is available at https://myquizgpt.com/llms.txt
**Purpose**: Comprehensive documentation for LLMs and AI assistants to understand MyQuizGPT's features, API, JSON formats, and integration methods.
**Standard**: This follows the llms.txt convention for providing structured information to Large Language Models and AI assistants.

## Overview

MyQuizGPT (https://myquizgpt.com) is an AI-powered educational platform that transforms any content into interactive quizzes, flashcards, and **Google Forms**-ready quizzes. Users can create study materials from PDFs, Word documents, Google Sheets, notes, ChatGPT conversations, or any text input—often by uploading those files **inside ChatGPT** while using the MyQuizGPT GPT. The platform integrates seamlessly with ChatGPT and provides instant study links for practice, sharing, learning, and export to Google Forms where supported.

## Core Features

### Quiz Creation
- **Multiple Choice Questions**: Generate quizzes with 2-4 options per question
- **Instant Feedback**: Real-time scoring and answer validation
- **Progress Tracking**: Track attempts, scores, and improvement over time
- **Leaderboards**: Compete with others on quiz leaderboards
- **Shareable Links**: Generate short 6-character URLs for easy sharing
- **Export Options**: Download quizzes as PDF or CSV

### Flashcard Generation
- **Front/Back Cards**: Traditional flashcard format with question and answer sides
- **Interactive Study**: Flip cards for memorization practice
- **Unlimited Creation**: Generate as many flashcards as needed
- **Topic-Based**: Create flashcards from any subject or material

### Content Sources
- **PDF Upload**: Convert PDF documents into quizzes/flashcards
- **Word & Office**: DOCX, PPTX, TXT (and related document uploads where the GPT or web uploader accepts them)
- **Google Sheets**: Spreadsheet-based content can be used as a source when provided via ChatGPT/MyQuizGPT flows (e.g. pasted data or uploaded/linked sheets, depending on the product surface)
- **Text Input**: Paste any text content for instant conversion
- **ChatGPT Integration**: Use the MyQuizGPT GPT in ChatGPT to generate quizzes/flashcards/Google Forms workflows while uploading PDFs, Word files, spreadsheets, or other supported docs directly in the chat
- **Google Forms**: Create quiz content suitable for Google Forms export via MyQuizGPT (ChatGPT + MyQuizGPT; see site pages such as /gpt-for-google-forms for details)
- **OCR Support**: Handles scanned documents and images

### User Management
- **Free Accounts**: 
  - Create unlimited quizzes and flashcards
  - Public share links (24-hour expiry for saved items)
  - Unlimited saved collections
  - Practice limited to 10 questions per quiz after 3 collections
  - Collections expire after 24 hours
- **Premium Accounts** ($27 one-time payment, lifetime access; limited-time promos such as referral/Black Friday may offer $24—see pricing page):
  - Unlimited permanent storage
  - Never lose your studies
  - Merge multiple study sets
  - Organize into collections and folders
  - Progress tracking and statistics
  - AI-powered study revisions
  - Leaderboard participation
  - Chat folders organization
- **Group Plans** (for teachers and team leaders):
  - **Group Plan (5 members)**: Add up to 5 members + admin = 6 total people ($60 one-time payment)
  - **Classroom Plan (50 members)**: Add up to 50 members + admin = 51 total people ($200 one-time payment)
  - Share premium access with your team, students, or colleagues
  - All members get full premium features
  - Group leader manages members and can enable/disable invite links
  - Members can join via invite link
  - Lifetime access for all members

### Advanced Features (Premium)
- **Merge Study Sets**: Combine multiple quizzes or flashcards into one
- **Collections Management**: Organize study sets into personal libraries
- **Chat Folders**: Group related study materials in folders
- **Progress Analytics**: Detailed statistics on study performance
- **Study Revisions**: AI-powered review and improvement suggestions
- **Favorites System**: Mark and quickly access favorite study sets
- **Revision Source Tracking**: Attach source URLs and notes to study sets

## How It Works

### For Users
1. **Via ChatGPT**: Open the MyQuizGPT GPT on ChatGPT; upload PDFs, Word documents, Google Sheets (or paste sheet data), or other supported files and ask for a quiz practice link, flashcards, or help creating content for Google Forms
2. **Direct Upload**: Visit myquizgpt.com/quiz-maker or /flashcard-generator (and related Google Forms tools on the site)
3. **JSON Fallback**: If ChatGPT action fails, paste JSON at myquizgpt.com/create
4. **Get Link**: Receive instant study link from ChatGPT action (e.g., myquizgpt.com/study?id=abc123)
5. **Practice**: Study, share, or save to collection

### For ChatGPT/LLMs
- **Discover Actions**: Read `/.well-known/ai-plugin.json` to discover the createStudyAsset custom action
- **Read Instructions**: Browse myquizgpt.com to read instructions
- **Generate Content**: Generate quiz/flashcard JSON in specified format
- **Call Action**: POST to `/api/create` endpoint via createStudyAsset action
- **Return Link**: Return practice URL to user
- **Fallback**: If action fails, provide JSON fallback with instructions to visit /create

## API Endpoints

### POST /api/create
Create a quiz or flashcard set and return a practice link.

**Request Format:**
```json
{
  "set_type": "quiz" | "flashcard",
  "title": "Short descriptive title",
  "data": [
    // Quiz items or flashcard items
  ]
}
```

**Response:**
```json
{
  "success": true,
  "public_id": "abc123",
  "set_type": "quiz",
  "url": "https://myquizgpt.com/study?id=abc123"
}
```

## JSON Format Examples

### Quiz Format
```json
{
  "title": "Basic English Grammar Quiz",
  "set_type": "quiz",
  "data": [
    {
      "question": "Which sentence is grammatically correct?",
      "options": [
        "She go to school every day.",
        "She goes to school every day.",
        "She going to school every day.",
        "She gone to school every day."
      ],
      "correct_answer": "She goes to school every day."
    },
    {
      "question": "What is the past tense of 'run'?",
      "options": ["run", "runned", "ran", "running"],
      "correct_answer": "ran"
    }
  ]
}
```

**Requirements:**
- `title`: String (max 200 characters)
- `set_type`: Must be "quiz"
- `data`: Array of question objects
- Each question must have: `question`, `options` (array of 2-4 strings), `correct_answer` (must match one option)
- Maximum 50 questions per quiz (100 items max via /create endpoint)

### Flashcard Format
```json
{
  "title": "French Basics",
  "set_type": "flashcard",
  "data": [
    {
      "front": "Hello",
      "back": "Bonjour"
    },
    {
      "front": "Thank you",
      "back": "Merci"
    },
    {
      "front": "Goodbye",
      "back": "Au revoir"
    }
  ]
}
```

**Requirements:**
- `title`: String (max 200 characters)
- `set_type`: Must be "flashcard"
- `data`: Array of flashcard objects
- Each flashcard must have: `front` (string), `back` (string)
- Maximum 50 flashcards per set (100 items max via /create endpoint)

## Fallback Instructions

**If the ChatGPT action fails, is disabled, or unavailable:**

Tell the user:
"⚠️ MyQuizGPT link generation is unavailable right now. I've generated your quiz/flashcard JSON data below. Please visit https://myquizgpt.com/create and paste the following JSON to create your study set:"

Then provide the complete JSON object with `title`, `set_type`, and `data` fields in the correct format.

The user can paste the JSON at https://myquizgpt.com/create to generate the practice link manually.

## Pricing

### Free Plan
- **Price**: $0
- **Features**:
  - Create unlimited quizzes and flashcards
  - Public share links
  - Unlimited saved collections
  - Collections expire after 24 hours
  - Progress tracking (limited)
- **Limitations**:
  - Saved items expire in 24 hours
  - Practice limited to 10 questions per quiz after 3 collections
  - No merge functionality
  - No folders organization

### Premium Plan
- **Standard Price**: $27 (one-time payment, lifetime access)
- **Promotional Price** (when active; e.g. Black Friday, referral, cancel offer): $24 (one-time payment—verify on myquizgpt.com/subscription/pricing)
- **Weekly Plan** (alternative): $3.99/week (cancel anytime)
- **Payment**: One-time for lifetime tiers; weekly plan billed per week via Stripe
- **Features**:
  - Everything in Free plan
  - Unlimited permanent storage
  - Never expires - save forever
  - Merge multiple study sets
  - Organize into collections and folders
  - Full progress tracking and analytics
  - AI-powered study revisions
  - Leaderboard participation
  - Chat folders for organization
  - Favorites system
  - Revision source tracking

### Group Plans (For Teachers & Team Leaders)
- **Group Plan (5 members)**: $60 one-time payment
  - Add up to 5 members + admin = 6 total people
  - Perfect for small teams, study groups, or small classes
  - All members get full premium access
  - Group leader manages members and invite links
- **Classroom Plan (50 members)**: $200 one-time payment
  - Add up to 50 members + admin = 51 total people
  - Ideal for teachers, instructors, and larger teams
  - All members get full premium access
  - Group leader manages members and invite links
- **Features**:
  - Share premium access with your entire team
  - Invite members via shareable link
  - Manage members (add/remove)
  - Enable/disable invite links
  - View group content and member activity
  - Lifetime access for all members

### Payment Processing
- **Provider**: Stripe
- **Method**: One-time payment for lifetime/group/classroom tiers; optional weekly subscription for the weekly plan
- **Currency**: USD
- **Checkout**: Many prices use dynamic `price_data` (cent amounts); confirm current amounts on the live pricing page

## Study Experience

### Quiz Mode
- Multiple choice questions with instant feedback
- Score calculation and percentage display
- Question-by-question navigation
- Review correct/incorrect answers
- Progress indicator
- Timer option
- Leaderboard integration

### Flashcard Mode
- Flip cards (front/back)
- Study all cards or specific subset
- Mark cards as known/unknown
- Shuffle option
- Progress tracking
- Review mode

## User Accounts

### Authentication
- **Method**: Google OAuth
- **No Password Required**: Sign in with Google account
- **Profile Customization**: 
  - Username (auto-generated or custom)
  - Avatar (Dicebear integration)
  - Theme color
  - Profile editing

### Collections
- Save study sets to personal collection
- Organize by favorites
- Track study attempts
- View statistics
- Free users: Unlimited saves, but practice limited to 10 questions per quiz after 3 collections. Collections expire after 24 hours.
- Premium users: Unlimited, never expires, full practice access

## Technical Details

### Study Set Storage
- **Public IDs**: 6-character encoded identifiers
- **Sharing**: Public share links work without login
- **Privacy**: Collections are private to user account

### Leaderboards
- Track quiz completions and scores
- Per-quiz leaderboards
- User rankings
- Time-based scoring
- Premium feature

### Study Revisions
- AI-powered review of study sets
- Improvement suggestions
- Content enhancement
- Premium feature

### Folders (Chat Folders)
- Organize study sets into folders
- Share folders with others
- Import shared folders
- Folder-level organization
- Premium feature

## Integration Points

### ChatGPT Integration
- **GPT Action**: createStudyAsset
- **Endpoint**: POST https://myquizgpt.com/api/create
- **AI Plugin Manifest**: https://myquizgpt.com/.well-known/ai-plugin.json (OpenAPI schema for custom action discovery)
- **Workflow**: Users can upload PDFs, Word (DOCX), spreadsheets/Sheets data, and other supported documents in ChatGPT while using MyQuizGPT to generate quizzes, flashcards, and Google Forms–oriented outputs (see site documentation for export paths)
- **Fallback**: JSON paste at /create if action unavailable
- **Instructions**: Available at myquizgpt.com for ChatGPT to read
- **llms.txt**: Available at https://myquizgpt.com/llms.txt for comprehensive platform documentation

**For AI Systems**: Read `/.well-known/ai-plugin.json` to discover the createStudyAsset custom action. This OpenAPI schema defines the action, request/response formats, and includes fallback instructions for when the action is unavailable.

### Direct Web Access
- **Quiz Maker**: myquizgpt.com/quiz-maker
- **Flashcard Generator**: myquizgpt.com/flashcard-generator
- **ChatGPT to Google Forms**: myquizgpt.com/gpt-for-google-forms (and related Google Forms tooling linked from the site)
- **JSON to Quiz**: myquizgpt.com/create (fallback method)
- **Study Viewer**: myquizgpt.com/study?id={public_id}
- **Profile**: myquizgpt.com/profile
- **Pricing**: myquizgpt.com/subscription/pricing
- **llms.txt**: myquizgpt.com/llms.txt (comprehensive platform documentation)
- **AI Plugin Manifest**: myquizgpt.com/.well-known/ai-plugin.json (OpenAPI schema for custom action discovery)

## Use Cases

### For Students
- Exam preparation
- Vocabulary building
- Concept memorization
- Self-assessment
- Study group sharing

### For Teachers
- Create quiz materials
- Generate flashcards for lessons
- Student assessment tools
- Revision materials
- E-learning content
- **Group Plans Available**: Add up to 50 students to your classroom plan
  - Share premium access with all students
  - Manage student memberships
  - Students join via invite link
  - View all student content and progress
  - Perfect for classrooms, study groups, and educational institutions

### For Professionals
- Training materials
- Certification prep
- Skill assessment
- Knowledge retention
- Corporate training

## Best Practices

### Quiz Creation
- Use clear, unambiguous questions
- Provide 4 options when possible
- Ensure correct_answer matches one option exactly
- Keep questions concise
- Test for accuracy before sharing

### Flashcard Creation
- Front: Question or term
- Back: Answer or definition
- Keep content focused
- Use consistent formatting
- Group related concepts

### JSON Validation
- Always include title, set_type, and data
- Verify correct_answer exists in options array
- Check data is an array (not object)
- Limit to 50 items for best performance
- Validate JSON syntax before submission

## Support & Resources

- **Website**: https://myquizgpt.com
- **Support Email**: hello@myquizgpt.com
- **Refund Policy**: 48-hour refund window
- **Terms**: Available at /terms
- **Privacy**: Available at /privacy
- **Contact**: Available at /contact

## Current Promotions

Promotional pricing changes over time. As of the last update to this file:
- **Lifetime premium (standard)**: $27 one-time
- **Limited-time / campaign pricing** (e.g. Black Friday, referral, cancel-trial offer): often **$24** one-time when a campaign is live—always confirm on **https://myquizgpt.com/subscription/pricing** (and any campaign-specific URLs such as Black Friday pricing pages).

## Platform Status

- **Status**: Active and operational
- **Uptime**: High availability
- **API**: RESTful API available
- **ChatGPT Integration**: Active
- **Payment Processing**: Stripe integration live

---

**Last Updated**: 2026-04
**Version**: 1.0
**Platform**: Web-based (responsive design)
**Browser Support**: Modern browsers (Chrome, Firefox, Safari, Edge)