The folder is the application.
Admit Protocol is an open way for a family to apply to a school from documents on their own computer, with their own AI agent. The school publishes one file that says what it wants and how to send it. The agent reads it, gathers what the family has, asks for what is missing, reads it all back, and sends it. A person at the school reads it.
Read https://apply.example-school.org/skill.md and help us apply from this folder.
One folder can be carried to any school that speaks the protocol. That is the point: the family does the work once, and the common application becomes something they own, not something a vendor hosts.
How it works
- The school serves
skill.md, a short document for agents, and a live JSON schema. - The family puts what they have in a folder: a note about the student, something the student wrote, report cards, scores, an IEP if they want it seen.
- The agent maps the folder to the school’s item types, asks about gaps, and reads the application back to the family.
- A parent or guardian confirms a code sent to their email. Nothing is sent before that.
- Items go in as text or files. The checklist shows what the school has and what is missing. Incomplete is allowed.
- The family submits when the required minimum is in. Everything else trickles in later, from the family, a teacher, or a registrar.
- The school’s people review it in their own system. The protocol never scores anyone.
Principles
- The student writes. Agents organize, transcribe and send. They do not draft, rewrite or polish the student’s words. Every piece of writing carries an attestation, and the server refuses one that says otherwise.
- People decide. No ranking, no scoring, no fit model. The protocol moves documents and questions, not judgments.
- A parent owns it. The verified email belongs to a parent or guardian. Students use the agent with a parent present.
- Incomplete is fine. Schools say what is required to submit, which should be little, and accept the rest as it arrives.
- The family’s data stays the family’s. The folder lives on their machine. The school keeps what it receives under a published retention rule.
- Open. The skill, the schema and the endpoints are public. Any school can implement them; any agent can speak them.
For schools
Adopting the protocol means serving three things on a domain you control: the skill file, the schema, and the endpoints below. The reference implementation also gives you an admissions desk for the documents and a connector that creates the candidate in your student information system (Blackbaud first), so your admissions team’s workflow does not change. Applications arrive next to the ones from your existing form; nothing is replaced until you choose.
Verde Valley School in Sedona, Arizona is the first school to accept applications this way, at apply.vvsaz.dev. To be the second, write to hello@admitprotocol.com.
For families
You need an agent that can read a web page and call an API: Claude Code, Claude Desktop, Cursor, Codex, Gemini CLI, and others. Claude Desktop, Claude mobile and ChatGPT can also connect to a school’s MCP address. Make a folder, put what you have in it, and give the agent the school’s skill address. The agent will tell you what it found, what it needs, and exactly what it is about to send. The student writes their own piece; the agent will not write it for them. There is no fee at participating schools.
The spec, v0.1 draft
Transport is plain HTTPS with JSON, plus an MCP server exposing the same operations. The live schema at /v1/schema is authoritative for a given school; this page describes the common shape.
Endpoints
| Method | Path | Purpose |
|---|---|---|
| GET | /skill.md | What an agent reads first: the school’s rules and the flow, in plain words. |
| GET | /v1/schema | The fields, enums, item types and checklist the school enforces, as JSON Schema. |
| POST | /v1/applications | Start. The school emails a 6-digit code to the parent or guardian. |
| POST | /v1/applications/{id}/verify | Prove the parent’s email. Returns an application token. |
| POST | /v1/applications/{id}/resend | Send a new code. |
| PATCH | /v1/applications/{id} | Change fields other than the verified parent. |
| POST | /v1/applications/{id}/items | Add a text item, such as the student’s writing with its attestation. |
| POST | /v1/applications/{id}/items/file | Add a file: PDF, JPG, PNG, HEIC or DOCX, 20 MB. |
| POST | /v1/applications/{id}/requests | Ask the school to contact a recommender or a registrar. |
| GET | /v1/applications/{id} | The checklist: received, missing, reviewed, and the next action. |
| POST | /v1/applications/{id}/submit | Hand the application to the school. |
| POST | /v1/applications/{id}/withdraw | Withdraw. |
| MCP | /mcp | The same operations as tools, for clients with connector support. |
Authentication
Starting an application needs nothing. Everything after verification sends Authorization: Bearer <application_token>, a token scoped to one application, stored by the agent in the family’s folder under .admit-protocol/. Codes expire in minutes and work once; tokens last about three months.
Common application fields
parent (name, email, relationship), student (names, date of birth, current school and grade, place, languages at home, international), entering_year, entering_grade, boarding_or_day, and an agent block naming the client. Schools may add fields; they should not remove these.
Item types
Family-sent: writingtranscriptreport_cardtest_scoreenglish_competencyiep_504additional. Requested by the school, never sent by the family: recommendation_mathrecommendation_englishrecommendation_counselorrecommendation_personal.
Writing attestation
{ "type": "writing", "title": "...", "text": "...",
"attestation": { "written_by": "student", "agent_edited": false, "confirmed_by": "parent" } }A server must refuse a writing item whose attestation differs from this.
Checklist
Status responses carry a checklist whose step names mirror the school’s own system, so staff never translate. Each step is missing, received, reviewed, waived or school (scheduled by the school, such as an interview). The reference steps:
- * Application · family
- * Student writing · family
- Transcripts · family
- Educational Testing · family
- English Competency Testing (TOEFL/IELTS) · family
- IEP/504 Documents · family
- Additional Information · family
- Mathematics Recommendation · recommender
- English Recommendation · recommender
- Principal/Counselor Recommendation · recommender
- Personal Recommendation · recommender
- Campus Tour · school
- Interview · school
Errors
400 with a list of rejected fields, 401 for a missing or expired token, 409 for a state conflict (already submitted, not ready to submit), 413 for a file over the limit, 429 for too many requests. Error bodies are { "error": "plain words", "details": [...] }.
Status of this document
Draft 0.1, November 2026. The reference implementation is the Verde Valley School instance. Breaking changes will bump the version in /v1/schema; a school’s skill file is the contract an agent should follow when the two disagree.