MCP Documentation

Last updated: March 20, 2026

1. What is Study Kit?

Study Kit is an MCP (Model Context Protocol) server that gives AI assistants like Claude and ChatGPT the tools to create structured, personalized learning experiences. Instead of plain-text Q&A, Study Kit provides interactive widgets, spaced repetition vocabulary, progress tracking, and AI-powered performance analysis — all persisted across sessions.

You talk to your AI assistant naturally. Study Kit handles the learning infrastructure behind the scenes.

2. Features

Learning Goals & Progress

Create goals like "Learn Vietnamese" or "IELTS Band 7." Study Kit tracks your progress across sessions with lessons, completion percentages, and performance analytics.

Interactive Questions

Over 20 question types rendered as interactive widgets — multiple choice, cloze (fill-in-the-blank), matching, ordering, translation, writing, listening comprehension, speaking, read-aloud, and IELTS/PTE-specific formats. Questions are answered directly in the widget, not as plain text.

Spaced Repetition Vocabulary

Vocabulary items enter a spaced repetition system (SRS) automatically. Review due flashcards with interactive cards that schedule the next review based on how well you know each word.

Speaking & Pronunciation

Record yourself speaking or reading aloud. Get AI-powered pronunciation scoring and feedback with detailed breakdowns.

Writing Evaluation

Submit written responses and receive AI-powered scoring with corrected text, band scores (for IELTS), and actionable feedback.

Performance Analytics

Track accuracy rates, strengths, weaknesses, and get AI-generated recommendations for what to study next. Performance data persists across sessions so the AI assistant can adapt to your level.

3. Setup Instructions

Connect in Claude

  1. Open Claude.ai or Claude Desktop
  2. Go to Settings → Integrations (or MCP Servers in Claude Desktop)
  3. Search for Study Kit in the MCP directory, or add the server URL manually
  4. Click Connect — you'll be redirected to sign in with your Study Kit account
  5. After signing in, you're ready to go. Try saying: "Help me learn Spanish"

Connect in ChatGPT

  1. Open ChatGPT
  2. Go to Settings → Connected Apps
  3. Search for Study Kit and click Connect
  4. Sign in with your Study Kit account when prompted
  5. Start learning — the AI will use Study Kit tools automatically

4. Authentication

Study Kit uses OAuth 2.1 with PKCE (Proof Key for Code Exchange) for secure authentication. When you connect Study Kit to Claude or ChatGPT:

  1. The AI platform redirects you to the Study Kit sign-in page
  2. You sign in with your email (one-time password) or Google account
  3. Study Kit issues a secure token back to the AI platform
  4. The token is used for all subsequent tool calls — you stay signed in

Permissions requested:

  • openid — verify your identity
  • email — associate your account
  • profile — display your name

Study Kit does not request access to your conversations, files, or any data outside of the Study Kit tools. See our Privacy Policy for details.

5. Usage Examples

Example 1: Start a new language goal

You say:

"Help me learn Vietnamese — I'm a complete beginner"

What happens:

  1. Study Kit creates a learning goal for Vietnamese (beginner level)
  2. The AI asks diagnostic questions to assess your starting level
  3. Based on your answers, the AI teaches key concepts (greetings, tones, basic phrases)
  4. You practice with interactive questions — multiple choice, translation, fill-in-the-blank (cloze)
  5. New vocabulary is saved to your spaced repetition deck automatically

Tools used: create_goal create_multiple_choice_question create_translation_question add_vocabs

Example 2: Review vocabulary

You say:

"Review my vocabulary"

What happens:

  1. Study Kit checks your spaced repetition queue for due vocabulary items
  2. An interactive flashcard widget appears — you see the term and try to recall the meaning
  3. You flip the card and grade yourself (Again, Hard, Good, Easy)
  4. The SRS algorithm schedules each card's next review based on your grade
  5. Words you struggle with (leeches) get flagged with mnemonic suggestions

Tools used: get_vocab_review_queue review_vocab

Example 3: Pronunciation practice

You say:

"Help me practice my English pronunciation"

What happens:

  1. The AI creates a read-aloud question with a sentence or passage for you to read
  2. An interactive widget appears with a record button and the text to read
  3. You record yourself reading the text aloud
  4. Study Kit analyzes your recording and provides pronunciation scoring with detailed feedback — word-level accuracy, stress, intonation
  5. The AI suggests which sounds to focus on and provides follow-up practice

Tools used: create_read_aloud_question submit_answer

6. Available Tools

Study Kit provides 40+ MCP tools organized into these categories:

Category Tools Description
Goals create_goal, update_goal, get_goal, list_goals Create and manage learning objectives
Lessons create_lesson, update_lesson, get_lesson, list_lessons Organize content into structured lessons
Questions 25+ create_*_question tools Interactive widgets: MCQ, cloze, writing, speaking, listening, matching, ordering, IELTS/PTE formats
Answers submit_answer, evaluate_writing Submit, validate, and AI-evaluate responses
Vocabulary add_vocabs, list_vocab, review_vocab, get_vocab_review_queue Spaced repetition flashcards with SRS scheduling
Analytics get_recent_activity, get_latest_user_performance Track progress, accuracy, strengths, and weak areas

7. Support

If you run into any issues or have questions: