Servers Playground How we check Submit a server

Lessonspace MCP by usefulapi

Working · 525 ms

io.usefulapi/lessonspacev1.4.0 Domain verified

Read Lessonspace sessions, recordings, transcripts, spaces and users; launch spaces, edit sessions.

Education

Source Website Registry entry

Try it

Call this server's tools from your browser. Nothing to install.

https://lessonspace.usefulapi.io/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

lessonspace_get_session

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

sessionstring, required

Session uuid (the `uuid` field of a session from lessonspace_list_sessions).

Lessonspace MCP by usefulapi MCP server | mcptry

Tools (9)

lessonspace_get_session

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

read-only

Argument	Type	Description
session*	string	Session uuid (the `uuid` field of a session from lessonspace_list_sessions).

Input schema (JSON)

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

lessonspace_get_session_recording

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/.

read-only

Argument	Type	Description
session*	string	Session uuid (the `uuid` field of a session from lessonspace_list_sessions).

Input schema (JSON)

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

lessonspace_get_session_transcript

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/.

read-only

Argument	Type	Description
session*	string	Session uuid (the `uuid` field of a session from lessonspace_list_sessions).

Input schema (JSON)

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

lessonspace_launch_space

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/.

destructive

Argument	Type	Description
id*	string	Your id for the space. The same id returns the same space; a new id creates a new space.
name	string	Display name of the space (defaults to the id).
user	object	The participant this link is for.
locale	string	Interface language.
server	string	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.
not_after	string	The link stops working at this time (default and maximum: 7 days after not_before, or after now).
record_av	boolean

lessonspace_list_sessions

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/.

read-only

Argument	Type	Description
page	integer	Page number, from 1 (default 1). Pass the previous reply's next_page. The page size is fixed by Lessonspace.
tags	object	Session tags to match (key/value; an empty value matches the key's existence).
search	string	A session uuid (exact), otherwise part of the session name.
user_ids	array	Lessonspace user ids (from lessonspace_list_users); sessions these users attended.
launch_id	string	The `id` given to lessonspace_launch_space (case-sensitive exact match).
space_ids	array	Space ids; only sessions held in these spaces (sent as repeated parameters).
user_name

lessonspace_list_space_sessions

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/.

read-only

Argument	Type	Description
page	integer	Page number, from 1 (default 1). Pass the previous reply's next_page. The page size is fixed by Lessonspace.
tags	object	Session tags to match (key/value; an empty value matches the key's existence).
space*	string	Space id (UUID, the `id` field of a space from lessonspace_list_spaces).
search	string	A session uuid (exact), otherwise part of the session name.
user_ids	array	Lessonspace user ids (from lessonspace_list_users); sessions these users attended.
launch_id	string	The `id` given to lessonspace_launch_space (case-sensitive exact match).
user_name	string	Part of a participant's name (case-insensitive).
date_after	string

lessonspace_list_spaces

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/.

read-only

Argument	Type	Description
page	integer	Page number, from 1 (default 1). Pass the previous reply's next_page. The page size is fixed by Lessonspace.
search	string	Part of the space name, alias or slug.
tag_key	string	Space tag key; needs tag_value.
user_ids	array	Lessonspace user ids that attended.
tag_value	string	Space tag value (case-insensitive exact match); needs tag_key.
date_after	string	Only spaces with sessions that ended after this.
date_before	string	Only spaces with sessions that started before this (may be earlier than date_after: the session then spans both).
session_ids	array	Session uuids; only spaces that held these sessions (sent as repeated parameters).

lessonspace_list_users

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/.

read-only

Argument	Type	Description
page	integer	Page number, from 1 (default 1). Pass the previous reply's next_page. The page size is fixed by Lessonspace.
role	array	One or more roles to keep (teacher, student, admin).
search	string	Part of a name or email.
space_ids	array	Space ids; users who attended sessions in these spaces (sent as repeated parameters).
session_ids	array	Session uuids; users who attended these sessions (sent as repeated parameters).

Input schema (JSON)

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

lessonspace_update_session

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}/.

destructive

Argument	Type	Description
name*	string	The session's name (required).
session*	string	Session uuid (the `uuid` field of a session from lessonspace_list_sessions).
recording_access_policy	array	Who may access the recording; [] = the organisation policy; omit to leave unchanged.

Input schema (JSON)

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

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "maxLength": 255,
      "minLength": 1,
      "description": "Your id for the space. The same id returns the same space; a new id creates a new space."
    },
    "name": {
      "type": "string",
      "maxLength": 255,
      "minLength": 1,
      "description": "Display name of the space (defaults to the id)."
    },
    "user": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "maxLength": 255,
          "minLength": 1,
          "description": "Your id for this participant (shows as external id)."
        },
        "name": {
          "type": "string",
          "maxLength": 255,
          "minLength": 1,
          "description": "The participant's name (default 'Guest')."
        },
        "email": {
          "type": "string",
          "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,}$",
          "maxLength": 320
        },
        "ghost": {
          "type": "boolean",
          "description": "Join invisibly (observer)."
        },
        "leader": {
          "type": "boolean",
          "description": "Teacher/host rights (Lessonspace default false)."
        },
        "record": {
          "type": "boolean",
          "description": "Record this participant's audio/video."
        },
        "single_use": {
          "type": "boolean",
          "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)."
        }
      },
      "description": "The participant this link is for."
    },
    "locale": {
      "enum": [
        "en",
        "fr",
        "it",
        "pl"
      ],
      "type": "string",
      "description": "Interface language."
    },
    "server": {
      "type": "string",
      "maxLength": 64,
      "minLength": 1,
      "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."
    },
    "not_after": {
      "type": "string",
      "description": "The link stops working at this time (default and maximum: 7 days after not_before, or after now)."
    },
    "record_av": {
      "type": "boolean",
      "description": "Record audio and video."
    },
    "summarise": {
      "type": "boolean",
      "description": "Create an AI lesson summary."
    },
    "not_before": {
      "type": "string",
      "description": "The link works from this time (default: now)."
    },
    "space_tags": {
      "type": "object",
      "description": "Tags put on the space.",
      "propertyNames": {
        "type": "string",
        "maxLength": 100,
        "minLength": 1
      },
      "additionalProperties": {
        "type": "string",
        "maxLength": 500
      }
    },
    "transcribe": {
      "type": "boolean",
      "description": "Transcribe the session (needed for lessonspace_get_session_transcript)."
    },
    "allow_guests": {
      "type": "boolean",
      "description": "Let people without an invitation join (Lessonspace default true)."
    },
    "session_tags": {
      "type": "object",
      "description": "Tags put on the session (for filtering later).",
      "propertyNames": {
        "type": "string",
        "maxLength": 100,
        "minLength": 1
      },
      "additionalProperties": {
        "type": "string",
        "maxLength": 500
      }
    },
    "record_content": {
      "type": "boolean",
      "description": "Record the whiteboard and documents (defaults to record_av)."
    },
    "video_layout_mode": {
      "enum": [
        "grid",
        "sidebar",
        "floating"
      ],
      "type": "string"
    }
  }
}

Input schema (JSON)

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

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "space"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 100000,
      "description": "Page number, from 1 (default 1). Pass the previous reply's next_page. The page size is fixed by Lessonspace.",
      "exclusiveMinimum": 0
    },
    "tags": {
      "type": "object",
      "description": "Session tags to match (key/value; an empty value matches the key's existence).",
      "propertyNames": {
        "type": "string",
        "maxLength": 100,
        "minLength": 1
      },
      "additionalProperties": {
        "type": "string",
        "maxLength": 500
      }
    },
    "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": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "A session uuid (exact), otherwise part of the session name."
    },
    "user_ids": {
      "type": "array",
      "items": {
        "type": "integer",
        "maximum": 9007199254740991,
        "exclusiveMinimum": 0
      },
      "maxItems": 50,
      "minItems": 1,
      "description": "Lessonspace user ids (from lessonspace_list_users); sessions these users attended."
    },
    "launch_id": {
      "type": "string",
      "maxLength": 255,
      "minLength": 1,
      "description": "The `id` given to lessonspace_launch_space (case-sensitive exact match)."
    },
    "user_name": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Part of a participant's name (case-insensitive)."
    },
    "date_after": {
      "type": "string",
      "description": "Only sessions created after this time (with date_before: the same as start_time_after plus end_time_before)."
    },
    "date_before": {
      "type": "string",
      "description": "Only sessions created before this time."
    },
    "duration_max": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 0,
      "description": "Maximum duration in seconds."
    },
    "duration_min": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 0,
      "description": "Minimum duration in seconds."
    },
    "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."
    },
    "in_progress_only": {
      "type": "boolean",
      "description": "Only sessions that are running now."
    },
    "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."
    },
    "user_external_id": {
      "type": "string",
      "maxLength": 255,
      "minLength": 1,
      "description": "The external id of a participant (exact, case-insensitive)."
    },
    "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."
    },
    "include_single_user": {
      "type": "boolean",
      "description": "Include sessions that had only one participant (hidden by default)."
    }
  }
}

Input schema (JSON)

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