For developers
Sapiens speaks MCP
Sapiens is a course framework with a door in it. Point an agent at one URL and it gets the brief a writer would receive — the learner, the course so far, the annotations left on it — and hands back the syllabus and lessons it wrote. Everything lands in a real library, exportable to PDF, EPUB or a Kindle.
Connect in a minute
One address, every client. There is no key to create and nothing to paste into an environment file.
Endpoint
https://getsapiens.com/api/mcpStreamable HTTP. A remote server, not a command running on your machine.
Signed in already? The in-app guide walks the same setup screen by screen.
Open the walkthroughHow it authenticates
OAuth 2.0, the way MCP expects it — so a compliant client discovers the rest on its own.
- The reader signs in, not you
- The first connection opens a browser window: the reader signs in to Sapiens and approves your client. No API key is ever created, pasted or rotated, and your agent never handles a password.
- Discovery is automatic
- The server publishes its metadata at /.well-known/oauth-authorization-server and /.well-known/oauth-protected-resource. A 401 from the door advertises the second one, so a compliant client can bootstrap from the endpoint alone.
- It acts as that one reader
- An agent sees that reader's courses and nothing else, and everything it writes lands in their library like any other course — visible, editable and theirs to delete.
What your agent can call
17 tools, in the order the authoring loop uses them. Sapiens hands over the brief; your agent brings the model and writes.
Courses
The authoring loop — ask for a brief, write from it, save what you wrote — plus the ordinary library operations around it.
get_syllabus_briefReadsThe brief a syllabus is written from: topic, audience, depth, language, and everything Sapiens knows about the learner.
create_courseWritesCreate the course from the syllabus your agent just wrote.
get_lesson_briefReadsThe brief for one module — its place in the course, what came before it, and any annotations the reader left.
save_lessonWritesStore the lesson your agent wrote, block by block.
save_artifactWritesStore a practice widget — quiz, flashcards, glossary, case study — at its place among the lesson's blocks.
list_coursesReadsEvery course in the reader's library.
get_courseReadsOne course in full: its syllabus, its lessons, and what is still unwritten.
add_moduleWritesAppend a module to the syllabus.
edit_moduleWritesRewrite a module's title and description.
reorder_modulesWritesPut the syllabus in a different order.
send_course_to_kindleCreditsMail a finished course to the reader's Kindle. Needs a Send-to-Kindle address saved in their settings.
delete_courseDeletesRemove a course and everything written for it. There is no undo.
The learner profile
Personalization that outlives any one course. Read it to write a better lesson; write to it when you learn something durable about the reader.
get_learner_profileReadsWho the reader is, the worlds their examples should come from, and what they already master.
update_learner_profileWritesChange those defaults. List fields are replaced rather than merged, so read before you write.
list_memoriesReadsThe durable facts Sapiens has recorded about this reader — the confirmed ones, and the ones still waiting to be accepted.
add_memoryWritesRecord one durable fact that should shape every future course, not just this one.
Account
What the reader has left to spend, and what the priced tools cost.
get_credit_balanceReadsThe reader's balance, and the price list for the tools that charge.
What it costs
- No creditsEverything your agent writes
- Your agent brings its own model, so Sapiens never runs one on its behalf and nothing is metered. Authoring access rides any paid plan, from the $19-a-year Agent Pass; reading a library stays free.
- CreditsSending a course to a Kindle
- That one mails a real file, so it stays priced. It is the only tool on this page that debits credits, and it needs a Send-to-Kindle address saved in the reader's settings.
Build something on it
Create an account, connect your agent, and the whole authoring loop is yours to drive.