Back

MCP server

Ask ChatGPT or Claude about your studies

Connect PupilBot once, and your AI can read your studies, your answers and mistakes, what is due for review and how your progress changes over time. It can also turn notes you paste into a new study.

You still practise in the web app, the iPhone app or the Telegram bot. Your AI reads your record and explains it; it never answers the questions for you.

Questions to ask your AI

Ask in your own words. Your AI picks the tools it needs and answers from your real practice data.

“Which topics am I weakest on, and why do I keep missing them?”
“Show me the questions I got wrong this week and explain each one.”
“What is due for review today, and what can wait until tomorrow?”
“How has my accuracy changed over the last 30 days?”
“Make me a 20-minute study plan from my weak spots.”
“Turn these lecture notes into a PupilBot study.”
Tools
7
Transport
Streamable HTTP
Auth
OAuth 2.1
Price
Free account

Server URL

https://www.pupilbot.com/mcp

Paste this into any MCP client. The first connection opens a PupilBot sign-in page where you approve the client — no API key to generate, nothing to configure. No account yet? Create one, it is free.

How to connect

Claude (web, desktop or mobile)

  1. Settings → Connectors → Add custom connector
  2. Name it PupilBot and paste https://www.pupilbot.com/mcp
  3. Claude opens the PupilBot sign-in — log in and approve
  4. Ask: “Which topics am I weakest on, and why do I keep missing them?”

ChatGPT

  1. Open Plugins, select +, then Add custom MCP server
  2. Name it PupilBot, enter https://www.pupilbot.com/mcp as the server URL and choose OAuth for authentication
  3. Select Create as a plugin, then sign in to PupilBot and approve
  4. Ask: “What is due for review today, and what can wait until tomorrow?”

OpenAI’s connect guide has the current steps. Your ChatGPT plan and workspace settings decide whether custom MCP servers are available.

Claude Code

Run this in your terminal:

claude mcp add --transport http pupilbot https://www.pupilbot.com/mcp

The first call opens the PupilBot sign-in in your browser. Approve it once and the connection persists.

Codex CLI

Add the server, then sign in — adding an OAuth-protected server does not start the sign-in on its own:

codex mcp add pupilbot --url https://www.pupilbot.com/mcp
codex mcp login pupilbot

Plugins for Claude Code and Codex

The PupilBot plugin adds this server and 3 skills: a study report that says what to practise next, today’s due reviews, and a new study from a file or pasted text.

Claude Code:

claude plugin marketplace add gabrielpolyy/pupilbot-plugins
claude plugin install pupilbot@pupilbot

Codex:

codex plugin marketplace add gabrielpolyy/pupilbot-plugins
codex plugin add pupilbot@pupilbot

In Claude Code, the skills run as /pupilbot:study-report, /pupilbot:due-today and /pupilbot:make-study. Both agents also use them when your request matches.

Cursor, Zed and other MCP clients

  1. Add an MCP server with transport http (streamable HTTP) and the URL https://www.pupilbot.com/mcp
  2. Complete the sign-in the client opens — clients register themselves, there is nothing to provision on our side

What your AI can read and do

7 tools, all limited to your own account. Every tool only reads, except create_study, which makes a new study from text you send. No tool can delete anything or see another student’s data.

ToolWhat it does
create_study Turns text you give your AI (notes, an article, a chapter) into a new study with topics and practice questions. It takes about a minute.
list_studies Your studies, newest first, with topic progress, reviews due now and when you last practised.
get_study One study in detail: its status, its question count, and every topic with its stage, mastery, recall estimate and next review.
get_answers Your answer history, newest first: the question, your answer, the correct answer, the feedback and the source line. Filter by study, topic, date, or mistakes only.
get_weak_spots Your weakest topics, the concepts you keep missing, and how many mistakes you made recently.
get_due What is due for review now, what comes due in the next 24 hours, and when the next review is, per study.
get_progress Answers and accuracy per day, your current streak, and how your mastery of each practised topic moved, over up to 180 days.

Privacy and access

Frequently asked questions

Can ChatGPT read my PupilBot progress?

Yes. In ChatGPT, open Plugins, select + and add PupilBot as a custom MCP server, then sign in and approve it. ChatGPT can then read your studies, answers, mistakes, due reviews and daily progress.

Does it work with Claude, Claude Code and Codex?

Yes. In Claude, add it as a custom connector. In Claude Code and Codex, add it with one terminal command. Any other app that supports remote MCP servers with OAuth sign-in works too.

Can my AI do my practice for me?

No. The tools read your record and can create a study from text, but they cannot answer questions or change your scores. You practise in the web app, the iPhone app or on Telegram.

Does it cost anything?

No. Connecting is free with any PupilBot account, and reading your data runs no AI model on PupilBot’s side. A study your AI creates counts toward your normal study allowance.

How do I disconnect an app?

Open Settings in the PupilBot web app and remove the app from your connected AI apps. Its access stops at once.

More ways to use PupilBot

For machines

Streamable HTTP, stateless: one JSON-RPC 2.0 request per POST, one JSON response. No SSE stream, no session ids, no JSON-RPC batching. A GET that asks for text/event-stream, and any DELETE, answer 405 — which is what tells a client to fall back to plain POSTs; a GET that does not ask for the stream gets this page. Protocol versions: 2025-06-18, 2025-03-26, 2024-11-05.

Discovery: /.well-known/oauth-authorization-server (RFC 8414) and /.well-known/oauth-protected-resource (RFC 9728). An unauthenticated POST answers 401 with a WWW-Authenticate challenge naming the second one.