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/mcp

Streamable HTTP. A remote server, not a command running on your machine.

Settings → Connectors → Add custom connector. Paste the endpoint, leave the advanced OAuth fields empty, and press Add. A browser window opens once so you can sign in and approve the access.

Signed in already? The in-app guide walks the same setup screen by screen.

Open the walkthrough

How 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_briefReads

    The brief a syllabus is written from: topic, audience, depth, language, and everything Sapiens knows about the learner.

  • create_courseWrites

    Create the course from the syllabus your agent just wrote.

  • get_lesson_briefReads

    The brief for one module — its place in the course, what came before it, and any annotations the reader left.

  • save_lessonWrites

    Store the lesson your agent wrote, block by block.

  • save_artifactWrites

    Store a practice widget — quiz, flashcards, glossary, case study — at its place among the lesson's blocks.

  • list_coursesReads

    Every course in the reader's library.

  • get_courseReads

    One course in full: its syllabus, its lessons, and what is still unwritten.

  • add_moduleWrites

    Append a module to the syllabus.

  • edit_moduleWrites

    Rewrite a module's title and description.

  • reorder_modulesWrites

    Put the syllabus in a different order.

  • send_course_to_kindleCredits

    Mail a finished course to the reader's Kindle. Needs a Send-to-Kindle address saved in their settings.

  • delete_courseDeletes

    Remove 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_profileReads

    Who the reader is, the worlds their examples should come from, and what they already master.

  • update_learner_profileWrites

    Change those defaults. List fields are replaced rather than merged, so read before you write.

  • list_memoriesReads

    The durable facts Sapiens has recorded about this reader — the confirmed ones, and the ones still waiting to be accepted.

  • add_memoryWrites

    Record 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_balanceReads

    The 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.