Lessonspace MCP by usefulapi
Read Lessonspace sessions, recordings, transcripts, spaces and users; launch spaces, edit sessions.
我该使用它吗
质量与安全性
A
发现（3）
- LOWTool 'lessonspace_get_session_recording' name length outside 3-30 range在 lessonspace_get_session_recording 中
- LOWTool 'lessonspace_get_session_transcript' name length outside 3-30 range在 lessonspace_get_session_transcript 中
- LOWTool 'lessonspace_list_space_sessions' name length outside 3-30 range在 lessonspace_list_space_sessions 中
基于对工具定义和协议合规性的自动分析。
上下文开销
~4,045token 数（工具定义）
~4.0 KB典型响应大小
对注意力有显著影响（占 128k 上下文窗口的 3.16%）
这是每次将服务器的工具加载到模型上下文窗口时所消耗的大致 token 数。数值越高，可用于其他任务的注意力就越少。
安装
一键安装
将以下内容添加到你的 `claude_desktop_config.json` 文件中：
{
"mcpServers": {
"lessonspace": {
"url": "https://lessonspace.usefulapi.io/mcp"
}
}
}远程端点
https://lessonspace.usefulapi.io/mcpstreamable-http它能做什么
工具清单
工具（9）
🟢 只读🟡 写入🔴 删除⚪ 未知
🟢lessonspace_list_sessions(search, include_single_user, duration_min, duration_max, start_time_after, ...)
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"
}🟢lessonspace_get_session(session)
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"
}🟢lessonspace_get_session_recording(session)
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"
}🟢lessonspace_get_session_transcript(session)
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"
}🔴lessonspace_update_session(session, name, recording_access_policy)
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"
}🟢lessonspace_list_spaces(search, session_ids, tag_key, tag_value, user_ids, ...)
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"
}🟢lessonspace_list_space_sessions(space, search, include_single_user, duration_min, duration_max, ...)
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"
}🔴lessonspace_launch_space(id, name, allow_guests, record_av, record_content, ...)
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"
}🟢lessonspace_list_users(role, search, space_ids, session_ids, page)
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"
}社区
证据
最近观测
已验证未记录版本9 个工具