Lessonspace MCP by usefulapi

List the organisation's sessions (a session is one meeting held in a space): name, uuid, start/end time, space, participants (name, email, role), guests, billable seconds, tags, summary and recording state. Filter by time, duration, participant, space, launch id or tags. Newest first as Lessonspace orders them. Each session's playback_url is an access link to its recording, and participant emails are personal data: treat both as sensitive and share them only with someone entitled to see them. GET /organisations/sessions/.

{
  "type": "object",
  "properties": {
    "search": {
      "description": "A session uuid (exact), otherwise part of the session name.",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "include_single_user": {
      "description": "Include sessions that had only one participant (hidden by default).",
      "type": "boolean"
    },
    "duration_min": {
      "description": "Minimum duration in seconds.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "duration_max": {
      "description": "Maximum duration in seconds.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "start_time_after": {
      "type": "string",
      "description": "ISO 8601 date (yyyy-mm-dd) or date-time with a timezone, e.g. 2026-10-01T09:00:00Z."
    },
    "start_time_before": {
      "type": "string",
      "description": "ISO 8601 date (yyyy-mm-dd) or date-time with a timezone, e.g. 2026-10-01T09:00:00Z."
    },
    "end_time_after": {
      "type": "string",
      "description": "ISO 8601 date (yyyy-mm-dd) or date-time with a timezone, e.g. 2026-10-01T09:00:00Z."
    },
    "end_time_before": {
      "type": "string",
      "description": "ISO 8601 date (yyyy-mm-dd) or date-time with a timezone, e.g. 2026-10-01T09:00:00Z."
    },
    "date_after": {
      "description": "Only sessions created after this time (with date_before: the same as start_time_after plus end_time_before).",
      "type": "string"
    },
    "date_before": {
      "description": "Only sessions created before this time.",
      "type": "string"
    },
    "user_ids": {
      "description": "Lessonspace user ids (from lessonspace_list_users); sessions these users attended.",
      "minItems": 1,
      "maxItems": 50,
      "type": "array",
      "items": {
        "type": "integer",
        "exclusiveMinimum": 0,
        "maximum": 9007199254740991
      }
    },
    "launch_id": {
      "description": "The `id` given to lessonspace_launch_space (case-sensitive exact match).",
      "type": "string",
      "minLength": 1,
      "maxLength": 255
    },
    "in_progress_only": {
      "description": "Only sessions that are running now.",
      "type": "boolean"
    },
    "tags": {
      "description": "Session tags to match (key/value; an empty value matches the key's existence).",
      "type": "object",
      "propertyNames": {
        "type": "string",
        "minLength": 1,
        "maxLength": 100
      },
      "additionalProperties": {
        "type": "string",
        "maxLength": 500
      }
    },
    "user_external_id": {
      "description": "The external id of a participant (exact, case-insensitive).",
      "type": "string",
      "minLength": 1,
      "maxLength": 255
    },
    "user_name": {
      "description": "Part of a participant's name (case-insensitive).",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "page": {
      "description": "Page number, from 1 (default 1). Pass the previous reply's next_page. The page size is fixed by Lessonspace.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 100000
    },
    "space_ids": {
      "description": "Space ids; only sessions held in these spaces (sent as repeated parameters).",
      "minItems": 1,
      "maxItems": 50,
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^[A-Za-z0-9._-]{1,128}$"
      }
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

One session by uuid, with its space, participants, guests, tags, summary and recording state. GET /organisations/sessions/{session}/.

{
  "type": "object",
  "properties": {
    "session": {
      "type": "string",
      "pattern": "^[A-Za-z0-9._-]{1,128}$",
      "description": "Session uuid (the `uuid` field of a session from lessonspace_list_sessions)."
    }
  },
  "required": [
    "session"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

The playback URL of a session's recording. status 'ready' = the URL works now; 'preparing' = Lessonspace is still creating it (ask again in a minute); 'no_recording' = recording was disabled, so none exists. The URL is an access link: give it only to someone entitled to watch the recording. GET /organisations/sessions/{session}/playback/.

{
  "type": "object",
  "properties": {
    "session": {
      "type": "string",
      "pattern": "^[A-Za-z0-9._-]{1,128}$",
      "description": "Session uuid (the `uuid` field of a session from lessonspace_list_sessions)."
    }
  },
  "required": [
    "session"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

A signed download URL for a session's transcript. Only works if transcription was switched on for the session (launch with transcribe=true). The URL is an access link: give it only to someone entitled to read the transcript. GET /organisations/sessions/{session}/transcript/.

{
  "type": "object",
  "properties": {
    "session": {
      "type": "string",
      "pattern": "^[A-Za-z0-9._-]{1,128}$",
      "description": "Session uuid (the `uuid` field of a session from lessonspace_list_sessions)."
    }
  },
  "required": [
    "session"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

WRITE: rename a session and optionally set who may watch its recording (a list of participant, admin, teacher, student; an empty list falls back to the organisation policy). The name is always sent (Lessonspace requires it). PATCH /organisations/sessions/{session}/.

{
  "type": "object",
  "properties": {
    "session": {
      "type": "string",
      "pattern": "^[A-Za-z0-9._-]{1,128}$",
      "description": "Session uuid (the `uuid` field of a session from lessonspace_list_sessions)."
    },
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 255,
      "description": "The session's name (required)."
    },
    "recording_access_policy": {
      "description": "Who may access the recording; [] = the organisation policy; omit to leave unchanged.",
      "maxItems": 4,
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "participant",
          "admin",
          "teacher",
          "student"
        ]
      }
    }
  },
  "required": [
    "session",
    "name"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

List the organisation's spaces (persistent rooms): id, name, slug, alias, url, tags, lock state, region and recording/transcription settings. The url of a space is a way in; treat it as sensitive. GET /organisations/spaces/.

{
  "type": "object",
  "properties": {
    "search": {
      "description": "Part of the space name, alias or slug.",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "session_ids": {
      "description": "Session uuids; only spaces that held these sessions (sent as repeated parameters).",
      "minItems": 1,
      "maxItems": 50,
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^[A-Za-z0-9._-]{1,128}$"
      }
    },
    "tag_key": {
      "description": "Space tag key; needs tag_value.",
      "type": "string",
      "minLength": 1,
      "maxLength": 100
    },
    "tag_value": {
      "description": "Space tag value (case-insensitive exact match); needs tag_key.",
      "type": "string",
      "minLength": 1,
      "maxLength": 500
    },
    "user_ids": {
      "description": "Lessonspace user ids that attended.",
      "minItems": 1,
      "maxItems": 50,
      "type": "array",
      "items": {
        "type": "integer",
        "exclusiveMinimum": 0,
        "maximum": 9007199254740991
      }
    },
    "assigned_to_ids": {
      "description": "Lessonspace user ids the space is assigned to.",
      "minItems": 1,
      "maxItems": 50,
      "type": "array",
      "items": {
        "type": "integer",
        "exclusiveMinimum": 0,
        "maximum": 9007199254740991
      }
    },
    "date_after": {
      "description": "Only spaces with sessions that ended after this.",
      "type": "string"
    },
    "date_before": {
      "description": "Only spaces with sessions that started before this (may be earlier than date_after: the session then spans both).",
      "type": "string"
    },
    "page": {
      "description": "Page number, from 1 (default 1). Pass the previous reply's next_page. The page size is fixed by Lessonspace.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 100000
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Sessions held in one space, with the join/leave log (who joined, left or went idle, and when) and the users connected now. Same filters as lessonspace_list_sessions. GET /spaces/{space}/sessions/.

{
  "type": "object",
  "properties": {
    "space": {
      "type": "string",
      "pattern": "^[A-Za-z0-9._-]{1,128}$",
      "description": "Space id (UUID, the `id` field of a space from lessonspace_list_spaces)."
    },
    "search": {
      "description": "A session uuid (exact), otherwise part of the session name.",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "include_single_user": {
      "description": "Include sessions that had only one participant (hidden by default).",
      "type": "boolean"
    },
    "duration_min": {
      "description": "Minimum duration in seconds.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "duration_max": {
      "description": "Maximum duration in seconds.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "start_time_after": {
      "type": "string",
      "description": "ISO 8601 date (yyyy-mm-dd) or date-time with a timezone, e.g. 2026-10-01T09:00:00Z."
    },
    "start_time_before": {
      "type": "string",
      "description": "ISO 8601 date (yyyy-mm-dd) or date-time with a timezone, e.g. 2026-10-01T09:00:00Z."
    },
    "end_time_after": {
      "type": "string",
      "description": "ISO 8601 date (yyyy-mm-dd) or date-time with a timezone, e.g. 2026-10-01T09:00:00Z."
    },
    "end_time_before": {
      "type": "string",
      "description": "ISO 8601 date (yyyy-mm-dd) or date-time with a timezone, e.g. 2026-10-01T09:00:00Z."
    },
    "date_after": {
      "description": "Only sessions created after this time (with date_before: the same as start_time_after plus end_time_before).",
      "type": "string"
    },
    "date_before": {
      "description": "Only sessions created before this time.",
      "type": "string"
    },
    "user_ids": {
      "description": "Lessonspace user ids (from lessonspace_list_users); sessions these users attended.",
      "minItems": 1,
      "maxItems": 50,
      "type": "array",
      "items": {
        "type": "integer",
        "exclusiveMinimum": 0,
        "maximum": 9007199254740991
      }
    },
    "launch_id": {
      "description": "The `id` given to lessonspace_launch_space (case-sensitive exact match).",
      "type": "string",
      "minLength": 1,
      "maxLength": 255
    },
    "in_progress_only": {
      "description": "Only sessions that are running now.",
      "type": "boolean"
    },
    "tags": {
      "description": "Session tags to match (key/value; an empty value matches the key's existence).",
      "type": "object",
      "propertyNames": {
        "type": "string",
        "minLength": 1,
        "maxLength": 100
      },
      "additionalProperties": {
        "type": "string",
        "maxLength": 500
      }
    },
    "user_external_id": {
      "description": "The external id of a participant (exact, case-insensitive).",
      "type": "string",
      "minLength": 1,
      "maxLength": 255
    },
    "user_name": {
      "description": "Part of a participant's name (case-insensitive).",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "page": {
      "description": "Page number, from 1 (default 1). Pass the previous reply's next_page. The page size is fixed by Lessonspace.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 100000
    }
  },
  "required": [
    "space"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

WRITE: create a space, or reuse the one with the same `id`, and get a join link (client_url) for one participant. The link is a live credential for a real person: share it only with that person and never post it elsewhere. Calling again with the same id reuses the space but issues a new link; it is not safe to repeat blindly. Lessonspace's own `secret` is never returned. POST /spaces/launch/.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 255,
      "description": "Your id for the space. The same id returns the same space; a new id creates a new space."
    },
    "name": {
      "description": "Display name of the space (defaults to the id).",
      "type": "string",
      "minLength": 1,
      "maxLength": 255
    },
    "allow_guests": {
      "description": "Let people without an invitation join (Lessonspace default true).",
      "type": "boolean"
    },
    "record_av": {
      "description": "Record audio and video.",
      "type": "boolean"
    },
    "record_content": {
      "description": "Record the whiteboard and documents (defaults to record_av).",
      "type": "boolean"
    },
    "transcribe": {
      "description": "Transcribe the session (needed for lessonspace_get_session_transcript).",
      "type": "boolean"
    },
    "summarise": {
      "description": "Create an AI lesson summary.",
      "type": "boolean"
    },
    "server": {
      "description": "Region of the space. If omitted, Lessonspace picks it from the IP location of this server, which is near the AI platform and not near the participant. When the user's region matters, pass the `region` of an existing space from lessonspace_list_spaces.",
      "type": "string",
      "minLength": 1,
      "maxLength": 64
    },
    "locale": {
      "description": "Interface language.",
      "type": "string",
      "enum": [
        "en",
        "fr",
        "it",
        "pl"
      ]
    },
    "video_layout_mode": {
      "type": "string",
      "enum": [
        "grid",
        "sidebar",
        "floating"
      ]
    },
    "session_tags": {
      "description": "Tags put on the session (for filtering later).",
      "type": "object",
      "propertyNames": {
        "type": "string",
        "minLength": 1,
        "maxLength": 100
      },
      "additionalProperties": {
        "type": "string",
        "maxLength": 500
      }
    },
    "space_tags": {
      "description": "Tags put on the space.",
      "type": "object",
      "propertyNames": {
        "type": "string",
        "minLength": 1,
        "maxLength": 100
      },
      "additionalProperties": {
        "type": "string",
        "maxLength": 500
      }
    },
    "user": {
      "description": "The participant this link is for.",
      "type": "object",
      "properties": {
        "name": {
          "description": "The participant's name (default 'Guest').",
          "type": "string",
          "minLength": 1,
          "maxLength": 255
        },
        "id": {
          "description": "Your id for this participant (shows as external id).",
          "type": "string",
          "minLength": 1,
          "maxLength": 255
        },
        "email": {
          "type": "string",
          "maxLength": 320,
          "format": "email",
          "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
        },
        "leader": {
          "description": "Teacher/host rights (Lessonspace default false).",
          "type": "boolean"
        },
        "ghost": {
          "description": "Join invisibly (observer).",
          "type": "boolean"
        },
        "record": {
          "description": "Record this participant's audio/video.",
          "type": "boolean"
        },
        "single_use": {
          "description": "The link works for one person only: once someone joins with it, nobody else can use it (the first person can rejoin until the session ends).",
          "type": "boolean"
        }
      }
    },
    "not_before": {
      "description": "The link works from this time (default: now).",
      "type": "string"
    },
    "not_after": {
      "description": "The link stops working at this time (default and maximum: 7 days after not_before, or after now).",
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

List the organisation's users: Lessonspace user id, name, email, role (teacher, student, admin), active state and external id. Names and emails are personal data. GET /organisations/users/.

{
  "type": "object",
  "properties": {
    "role": {
      "description": "One or more roles to keep (teacher, student, admin).",
      "minItems": 1,
      "maxItems": 3,
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "teacher",
          "student",
          "admin"
        ]
      }
    },
    "search": {
      "description": "Part of a name or email.",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "space_ids": {
      "description": "Space ids; users who attended sessions in these spaces (sent as repeated parameters).",
      "minItems": 1,
      "maxItems": 50,
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^[A-Za-z0-9._-]{1,128}$"
      }
    },
    "session_ids": {
      "description": "Session uuids; users who attended these sessions (sent as repeated parameters).",
      "minItems": 1,
      "maxItems": 50,
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^[A-Za-z0-9._-]{1,128}$"
      }
    },
    "page": {
      "description": "Page number, from 1 (default 1). Pass the previous reply's next_page. The page size is fixed by Lessonspace.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 100000
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}