{
  "name": "ObserveNote agent API",
  "version": "2026-09-01",
  "description": "ObserveNote records short, timestamped classroom observations against observation areas and indicators, then turns that evidence into Ontario report-card comments and E/G/S/N learning-skill ratings.",
  "tagline": "Classroom observations that become report-card comments",
  "docs": "https://observenote.com/agents",
  "mcp": "https://observenote.com/mcp",
  "llms": [
    "https://observenote.com/llms.txt",
    "https://observenote.com/llms-full.txt"
  ],
  "endpoints": [
    {
      "path": "/api",
      "method": "GET",
      "returns": "this document"
    },
    {
      "path": "/api/learning-skills",
      "method": "GET",
      "returns": "the six Ontario learning skills and work habits, the E/G/S/N scale, and which observation areas feed each skill"
    },
    {
      "path": "/api/observation-areas",
      "method": "GET",
      "params": {
        "area": "area code, e.g. selfreg",
        "valence": "strength | growth"
      },
      "returns": "observation areas with the strength and growth indicators a teacher taps in the room"
    },
    {
      "path": "/api/comment-guidance",
      "method": "GET",
      "params": {
        "area": "area code",
        "valence": "strength | growth",
        "name": "student first name to fill {{name}}",
        "pronouns": "one of she/her, he/him, they/them"
      },
      "returns": "report-card sentence templates, rendered when name and pronouns are supplied"
    },
    {
      "path": "/api/curriculum",
      "method": "GET",
      "params": {
        "panel": "elementary | secondary"
      },
      "returns": "the Ontario curriculum documents and grade levels the app is seeded with"
    },
    {
      "path": "/mcp",
      "method": "GET, POST",
      "returns": "MCP server over the same data (streamable HTTP, JSON responses)"
    }
  ],
  "limits": "No student data is exposed here and none ever will be: every observation belongs to a teacher inside an authenticated tenant. This API serves jurisdiction reference material and comment templates only.",
  "jurisdiction": {
    "code": "ON",
    "name": "Ontario",
    "country": "CA",
    "language": "en"
  },
  "license": {
    "name": "ObserveNote agent access",
    "terms": "https://observenote.com/agents",
    "attribution": "ObserveNote — https://observenote.com/",
    "summary": "Free for agent and research use with attribution and a link back. Reference material is transcribed from Ontario policy documents; drafted comments are templates for a teacher to edit, never finished report-card text."
  },
  "notices": [
    "ObserveNote is an independent product for teachers. It is not affiliated with, endorsed by or sponsored by the Ontario Ministry of Education or any school board. Curriculum and Growing Success material is cited to identify the policy it follows.",
    "Drafts are assembled from review-ready templates and the observations a teacher actually recorded. They are a starting point for professional judgement, never a substitute for it, and every sentence should be edited and verified before it reaches a report card."
  ]
}