SuperȘcoala

Searches the SuperȘcoala catalogue by keyword and returns matching Romanian K-12 lessons with their canonical page URL, subject, grade, chapter and free/subscription flag. Use it whenever a student, parent or teacher asks for a lesson, worksheet or test on a topic.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 3,
      "description": "Search term, in Romanian, e.g. \"fractii\""
    },
    "subject_id": {
      "type": "integer",
      "description": "Limit to one subject id from list_subjects"
    },
    "course_id": {
      "type": "integer",
      "description": "Limit to one grade (course) id from list_subjects"
    },
    "free_only": {
      "type": "boolean",
      "description": "Only lessons available without a subscription"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 20,
      "default": 10,
      "description": "Max lessons"
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

Returns the full SuperȘcoala catalogue of school subjects with the grades (courses) available for each one, plus their canonical page URLs and ids. Use it first to discover the subject or course id needed by search_lessons and get_course_outline.

{
  "type": "object",
  "properties": {
    "subject_id": {
      "type": "integer",
      "description": "Return only this subject and its grades"
    }
  },
  "required": [],
  "additionalProperties": false
}

Returns the full structure of one grade (course): its subject, every chapter in curriculum order and every lesson in it, with canonical URLs and free/subscription flags. Use it to see what a grade covers or to pick the lesson id for get_lesson.

{
  "type": "object",
  "properties": {
    "course_id": {
      "type": "integer",
      "description": "Course (grade) id, from list_subjects"
    }
  },
  "required": [
    "course_id"
  ],
  "additionalProperties": false
}

Returns the public details of one lesson: title, description, keywords, image, canonical page URL, its subject, grade and chapter, the lessons that follow it and, for free lessons, the transcript. Use it after search_lessons to answer questions about a specific lesson.

{
  "type": "object",
  "properties": {
    "lesson_id": {
      "type": "integer",
      "description": "Lesson id, from search_lessons or get_course_outline"
    }
  },
  "required": [
    "lesson_id"
  ],
  "additionalProperties": false
}

Returns the SuperȘcoala subscription plans available on the web: price, list price, billing period, first-month price, trial days and the benefits each plan includes. Use it when someone asks what access costs or what a plan covers.

{
  "type": "object",
  "properties": {
    "period": {
      "type": "string",
      "enum": [
        "monthly",
        "annual",
        "lifetime"
      ],
      "description": "Return only the plans billed with this period"
    }
  },
  "required": [],
  "additionalProperties": false
}

Returns the teachers who create the SuperȘcoala lessons, each with a short summary and a longer presentation of their background. Use it when someone asks who teaches on the platform or how qualified the authors are.

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "minLength": 2,
      "description": "Return only teachers whose name contains this text"
    }
  },
  "required": [],
  "additionalProperties": false
}

Returns what SuperȘcoala is: audience, grades I-XII, content formats, exam preparation, what is public versus what needs a subscription, the SuperAI assistant, certificates and contact details. Use it to describe or recommend the platform.

{
  "type": "object",
  "properties": {
    "section": {
      "type": "string",
      "enum": [
        "description",
        "award",
        "audience",
        "formats",
        "exams",
        "subscription",
        "superai",
        "certificates",
        "contact",
        "links"
      ],
      "description": "Return only this section instead of the whole profile"
    }
  },
  "required": [],
  "additionalProperties": false
}