For AI assistants
Aripsy MCP server
The Aripsy MCP server lets AI assistants such as Claude create study packs from your notes: exam-style revision notes, flashcards and practice questions with mark schemes, kept in your Aripsy account. You connect once with your Aripsy login, and each new pack uses the same allowance as the website.Connection details
Server URL
https://aripsy.com/api/mcpOAuth client ID for Claude
e8e2db5e-d948-4546-923f-5d7388ad27e2Available in Claude. ChatGPT and other assistants can’t connect yet.Remote server · Streamable HTTP · OAuth sign-in, no API key
Examples
What you can ask
Ask in plain words and include your own material. Claude picks the Aripsy tool it needs.“Turn my notes on the Weimar Republic’s 1923 crisis into flashcards and exam questions.”
Revision notes, flashcards and practice questions with marks, saved to your Aripsy study history.Usescreate_study_pack_from_text“Find my coasts pack and test me on the sea stacks questions.”
Claude finds the pack and asks you its practice questions, with the mark scheme ready for after you answer.Useslist_study_packsget_study_pack“Quiz me on the Aripsy flashcards I have due today.”
The flashcards you’ve reviewed before that are now due, oldest first.Usesget_due_flashcards“Write ten multiple-choice questions on opportunity cost from these notes and save them to Aripsy.”
Claude writes the questions and Aripsy stores them, labelled as assistant-written, with a link to practise.Usessave_study_pack
Setup
Connect Claude in five steps
You need an Aripsy account, Free or Pro, and Claude on the web or in the desktop app. Claude renames its menus now and then; the fields stay the same.Claude Team and Enterprise
An owner adds the connector once in Organization settings. Each member then connects their own Aripsy account from Customize, then Connectors.Other assistants
ChatGPT, Cursor, VS Code and other MCP clients can’t connect yet. Aripsy only accepts sign-in from assistants it has registered, and Claude is the first.Open Claude’s connectors
In Claude, open Customize, then Connectors. Choose Add, then Add custom connector.Paste the server URL
Name the connector Aripsy, pastehttps://aripsy.com/api/mcpas the URL and continue.Use Aripsy’s OAuth client
When Claude asks about the OAuth client, choose to use your own. Paste the client IDe8e2db5e-d948-4546-923f-5d7388ad27e2and leave the client secret empty.Allow access on Aripsy
Sign in to Aripsy. The consent screen lists what Claude will be able to do; select Allow study access.Switch it on in a chat
In a chat, open the + menu, then Connectors, and turn on Aripsy. Try asking: Check my Aripsy plan.
Tools
Seven tools, all about your study packs
Five of them only read. No tool can delete anything or change the packs already in your account.Create and save
- Turns study text you give Claude, up to about 5,000 words a call, into exam-style revision notes, flashcards and practice questions with marks and mark schemes. You can set the subject, exam board and level, and on Pro ask for multiple-choice questions too. The pack is saved to your study history.Adds to your accountUses one study pack
Create a study pack
create_study_pack_from_text - Larger packs can take a minute or two. If a pack isn’t ready yet, Claude collects it with this tool instead of starting again.Read-onlyNo allowance used
Finish a larger pack
get_study_pack_result - Stores notes, flashcards, practice questions or multiple-choice questions that Claude wrote from your material. Aripsy labels the pack as assistant-written and doesn’t check it against a source.Adds to your accountNo allowance used
Save a pack Claude wrote
save_study_pack
Practise what you saved
- Your saved packs, most recent first, with subject, exam board, how many items each has and how many flashcards are due. Claude can filter by subject.Read-onlyNo allowance used
List your packs
list_study_packs - The flashcards, practice questions with mark schemes and multiple-choice questions of one pack, plus its notes when Claude asks for them.Read-onlyNo allowance used
Open a pack
get_study_pack - Flashcards you’ve reviewed in Aripsy whose next review is due, oldest first.Read-onlyNo allowance used
Get due flashcards
get_due_flashcards
Your plan
- Your plan, the study packs left today and this period, the words one call accepts and your saved-pack storage. It never returns your name, email or other personal details.Read-onlyNo allowance used
Check your plan
get_account_capabilities
Practice card
In assistants that support MCP Apps, a pack can open as a practice card in the chat, with flashcards and a multiple-choice quiz. Practice in the card isn’t added to your Aripsy progress; open the pack in Aripsy to track your reviews.Plans and limits
Compare plansThe same allowance as the website
The MCP server has no separate price. New packs made through Claude come out of your Aripsy plan, together with the ones you make on the website.| Limit | Free | Pro |
|---|---|---|
| New study packs a month | 15 | 300 |
| New study packs a day | Up to 5 | No daily cap |
| Words in one tool call | About 5,000 | About 5,000 |
| Multiple-choice questions in new packs | Not included | When you ask |
| Saved packs | Up to 50 | Unlimited |
| Saving packs Claude wrote | Up to 20 a day | Up to 20 a day |
| Reading packs and due flashcards | No allowance used | No allowance used |
Security and privacy
You decide what Claude can do
The connection uses your Aripsy sign-in and the same content rules as the website.Sign-in with OAuth
You sign in on aripsy.com and approve the connection on Aripsy’s own consent screen. Claude gets an access token for Aripsy’s study tools, never your password.Only what Claude sends
Aripsy receives what Claude sends in a tool call, such as the study text for a pack. It can’t see your conversations with Claude.Read and add, never delete
Claude can read your saved packs and due flashcards, create and save new packs, and check your plan. No tool can delete anything or change the packs you already have.Same content rules
Study text is handled as on the website: it may be sent to third-party AI providers to make the pack, and Aripsy does not train its own AI models on it. A generated result is kept for up to seven days so a retried request returns the same pack.Disconnect at any time
On aripsy.com, open Connected assistants and choose Disconnect. Aripsy stops Claude’s tool calls straight away and revokes its sign-in. You can also remove the connector in Claude.Check what you learn
AI-generated study material can contain mistakes, so check important facts against your original source.
FAQ
Questions about the Aripsy MCP server
What is the Aripsy MCP server?
A remote MCP (Model Context Protocol) server at https://aripsy.com/api/mcp. It lets an AI assistant such as Claude use Aripsy for you: create a study pack from your notes, quiz you on packs you’ve saved, save packs it wrote and check your plan.
Which AI assistants work with Aripsy?
Claude, on the web and in the desktop app, as a custom connector. ChatGPT, Cursor, VS Code and other MCP clients can’t connect yet, because Aripsy only accepts sign-in from assistants it has registered. Claude’s consumer apps are for people aged 18 and over, so younger students should use Aripsy on the website.
Does connecting Claude cost extra?
No. The connector works on Aripsy’s Free and Pro plans, and new packs use the same allowance as the website. On Claude’s side, custom connectors are available on its Free plan (one connector) and on Pro, Max, Team and Enterprise.
Why do I paste a client ID?
Aripsy’s sign-in server doesn’t let assistants register themselves, so Claude needs Aripsy’s client ID to start the sign-in. The ID is public and isn’t a password. Leave the client secret empty.
What can Claude see in my Aripsy account?
Only what a tool returns when Claude calls it: your saved study packs, the flashcards due for review and your remaining allowance. The tools don’t return your email address, payment details or settings, and they can’t delete or change your packs.
Can I send a PDF or slides through Claude?
The tools take text. Paste the text into the chat, or upload the file in the Aripsy study tool on the website, where document uploads follow your plan.
What happens when I reach my limit?
The tool tells Claude that the allowance is used up and links to Aripsy’s plans. Claude shouldn’t retry. Your allowance resets on your plan’s schedule.
How do I disconnect Claude?
Open Connected assistants on aripsy.com and choose Disconnect next to Claude. Aripsy stops its tool calls straight away and revokes the sign-in. You can also remove the connector in Claude’s settings.
For AI assistants