# Peerfold

> Everything an AI coding agent needs to build on Peerfold — the API, the auth flows, the SDKs, the recipes, and the rules that keep you out of trouble.

Peerfold is a multi-tenant learning platform with a public HTTP API (OpenAPI 3.1), typed TypeScript SDKs, and a remote MCP server. Learner-plane requests are made against a workspace's portal origin with a short-lived learner token; admin/server requests against `https://app.peerfold.com` with a secret key.

## Docs

- [What Peerfold is](https://app.peerfold.com/llms-full.txt#what-peerfold-is): A multi-tenant learning platform with a public HTTP API, typed SDKs and a remote MCP server — you build the surface, it holds the courses, learners and results.
- [Connecting your agent](https://app.peerfold.com/llms-full.txt#connect): Assistants paste a URL and sign in; programmatic clients carry a secret key and a base URL.
- [Choosing an auth model](https://app.peerfold.com/llms-full.txt#auth): Four flows, one decision: who is proving the learner is who they say they are.
- [The resource map](https://app.peerfold.com/llms-full.txt#resource-map): What lives where: learner-plane resources for the browser, admin-plane resources for your server.
- [Golden paths](https://app.peerfold.com/llms-full.txt#recipes): The handful of jobs almost every integration does, with the code that does them.
- [Peerfold Sites](https://app.peerfold.com/llms-full.txt#sites): Sites, pages and publishing under /api/v1/sites: two planes, a trust tier and a plan level per operation, and pages written as batches of edits to a component tree.
- [Course content: the block model](https://app.peerfold.com/llms-full.txt#blocks): Lesson bodies are typed block JSON — a public, versioned contract you render, and the thing to fetch the schema for before you write any.
- [Guardrails](https://app.peerfold.com/llms-full.txt#guardrails): Sandbox first, secrets never in files, and the write semantics that surprise people.
- [Where to look things up](https://app.peerfold.com/llms-full.txt#reference): The generated contract, the deep index, and the in-app docs.

## Reference

- [OpenAPI 3.1 contract](https://app.peerfold.com/api/v1/openapi.json): Every endpoint, request and response — the source of truth the SDKs and docs are generated from.
- [Full agent knowledge](https://app.peerfold.com/llms-full.txt): This content in full, plus a one-line index of every API operation.
- [Developer docs](https://app.peerfold.com/help/dev): API reference, webhooks, MCP server and learner auth, personalized to a workspace.
- [MCP server](https://app.peerfold.com/api/mcp): Streamable HTTP; tenant-scoped authoring, enrollment, reporting and API-discovery tools.