← Pencil SpacesCONTENT HISTORY
WHAT CHANGED
Update to Pencil Spaces
Snapshot Oct 24, 2026 · 12:57 UTC · version 2.0.0
Collection source: downloaded plugin package.
First saved snapshot
No earlier snapshot is available to establish a change.
Save Pencil Spaces and check future changes in Following.
Up to 3 plugins free · no card required.
Compare saved observations
Download comparison JSONFull technical diff · 0 changed fields
Full snapshot data
{
"description": "Use when working with Pencil Spaces data through the pencil-spaces connector — listing or managing an institution's users, virtual classrooms (Spaces), scheduled events, programs, cohorts, sessions, recordings, transcriptions, attendance, availability, sites, custom attributes, alerts, or webhooks. Covers ID formats, base64-encoded filters, custom-attribute syntax, and multi-step workflows (e.g. finding a recording or attendance for a class).",
"included_files": [
{
"relative_path": "references/reference.md",
"size_in_bytes": 39125
}
],
"name": "pencil-spaces",
"skill_md_contents": "---\nname: pencil-spaces\ndescription: Use when working with Pencil Spaces data through the pencil-spaces connector — listing or managing an institution's users, virtual classrooms (Spaces), scheduled events, programs, cohorts, sessions, recordings, transcriptions, attendance, availability, sites, custom attributes, alerts, or webhooks. Covers ID formats, base64-encoded filters, custom-attribute syntax, and multi-step workflows (e.g. finding a recording or attendance for a class).\n---\n\n# Pencil Spaces\n\nPencil Spaces is a virtual-classroom platform. The connector exposes read\ntools for every entity and opt-in write tools (create/update only — nothing\ncan be deleted). For the complete per-tool parameter tables and response\nshapes, read `references/reference.md`.\n\n## Conventions that prevent failed calls\n\n- **IDs**: every `*Id` parameter is a 24-character hex MongoDB ObjectId\n (`507f1f77bcf86cd799439011`). Never pass names or emails where an ID is\n expected — look the entity up first.\n- **`filters` parameters are base64-encoded JSON.** Build the JSON object,\n then pass `base64(JSON.stringify(obj))`. The shape differs per tool —\n check `references/reference.md` before encoding. Common mistakes: passing\n raw JSON (must be base64), or nesting `timeRange` wrong for events\n (`{\"timeRangeStart\": \"...\", \"timeRangeEnd\": \"...\"}` flat keys are\n accepted and normalized).\n- **Custom attributes** are arrays of `\"keyId:valueId\"` strings — both\n halves are IDs from `get_attributes`, not display names.\n- **Attendance statuses are Pascal case**: `Present`, `Late`, `Absent`,\n `Left`, `Excuse` (write) — uppercase variants are rejected.\n- **Availability slots**: `day` is 0–6 (0 = Sunday); times are `HH:mm`\n 24-hour strings when setting, minutes-from-midnight integers when reading.\n- **Dates**: ISO 8601 timestamps; program cancellations use `YYYY-MM-DD`.\n- **Pagination**: `pageNumber` (default 1) and `pageSize` (default 25,\n max 100) on list tools.\n- **User references** in event/space tools are objects with exactly one of\n `userId` or `email` — never bare strings.\n\n## Multi-step workflows\n\n- **Recording/transcript of a class**: `list_sessions` (or `list_events` →\n session) → `get_session` → `get_space_recordings` → `download_recording`\n (presigned URL) and/or `get_transcription`.\n- **Attendance for a class**: `list_events` (base64 time filter) →\n `get_attendance` with the eventId. Only past events have attendance.\n- **Who is free at time X**: `get_available_users` with the window, or\n `get_user_availability` for one person.\n- **Program structure**: `list_programs` → `get_program` → `list_cohorts` /\n `list_program_cancellations`.\n- **Entity graph**: program → cohorts → events → space → sessions →\n recordings → transcription. Users belong to sites; attributes tag\n users/spaces/events.\n\n## Write tools\n\nWrite tools (create/update only) execute only when the connection was\ngranted write access — the user picks \"Read and edit\" on the OAuth consent\nscreen when connecting. If a write call returns \"Write operations are\ndisabled for this connection\", tell the user to reconnect and choose\n\"Read and edit\"; do not retry.\n\nBefore any write, confirm the target with a read (e.g. `get_event` before\n`update_event`). Updates replace provided fields wholesale — for list-valued\nfields (attendees, organizers, cohort members, availability slots) fetch the\ncurrent value, modify it, and send the full list back.\n"
}SHA-256 of public snapshot: 09cdba961d0961ad0b82f2b7c56049d841f43243a36f480b2890405c08268f3e