Pencil Spaces

Get a Control Center alert by ID. Returns the alert's type (e.g. TEACHER_DECLINED_EVENT, EVENT_NO_SHOW), status, priority, linked entity, and — always present, null when unset — triggeredBy, assignedTo, and resolution.

get_alert

Get the audit log history for a specific document. Returns a list of changes (create, update, delete) with actor information and change details.

get_audit_log

Get billing sessions report. Returns individual session details with duration and cost within a specified date range.

get_billing_sessions

Get details for a specific cohort within a program. Returns name, description, dates, and enrolled students.

get_cohort

Get details for a specific event by its ID. Returns title, time range, organizers, attendees, location, and recurrence info.

get_event

Get attendance records for a past event. Returns each attendee's status (Present, Late, Absent, Cancelled).

get_attendance

Get the institution attendance report for a date range in a single call. Returns one row per user with `user` (userId, name, email, profilePic) and `statuses`, the user's attendance status counts (e.g. Present, Late, Absent) across all events in the range. Use this instead of calling get_attendance per event when you need attendance across many events. The range cannot exceed 90 days.

get_attendance_report

Get details for a specific program by its ID. Returns name, description, dates, site association, and cohort count.

get_program

Get a specific cancellation for a program by its ID.

get_program_cancellation

Get a time-limited presigned download URL for a specific recording file.

download_recording

Get detailed analytics for a specific session including attendees, call stats, whiteboard metrics, and chat metrics.

get_session

Get the coaching and safeguarding reports for a session, derived from its recordings. Either field is null when no data is available (e.g. no recordings, no insights, or no safeguarding document).

get_session_reports

Get details for a specific site. Optionally include associated users and events.

get_site

Get the transcription for a recording. Returns timestamped transcript entries with speaker information, and an optional AI-generated summary.

get_transcription

Get the profile of a specific user by their user ID. Returns name, email, role, custom attributes, and site associations.

get_user

Get availability slots for a specific user. Returns their weekly recurring availability windows and timezone.

get_user_availability

Get the current webhook configuration for the institution. Returns the configured webhook URL and whether a signing secret is configured.

get_webhook_config

Invite a user to the institution via email. The user receives an invitation email. Requires an explicit write opt-in.

invite_user

List all accessible Spaces (virtual classrooms/collaboration rooms) with optional pagination and filters. Returns paginated space objects including title, visibility, and user counts.

list_spaces

Get users who are available within a specified time range. Returns paginated user availability slots.

get_available_users

List all cohorts (student groups) within a specific program. Returns all cohorts for the program (not paginated).

list_cohorts

Get all custom attributes defined for the institution. Each attribute has a key and an array of possible values that can be assigned to users or events.

get_attributes

List scheduled events with optional pagination and filters. Returns paginated event objects including title, time, organizers, and attendees.

list_events

Get all cancellations configured for a program, sorted by start date ascending. Available for programs in any status, including archived.

list_program_cancellations

List all programs (structured learning paths) with optional pagination. Returns paginated program objects including name, dates, and status.

list_programs

List recordings across all Spaces with optional time range and pagination. Returns recording metadata including duration, size, and associated space.

list_recordings

Get recordings for a specific Space with optional time range filtering. Returns all recording metadata for the space.

get_space_recordings

List sessions (analytics) with optional pagination and filters. Returns session analytics data including duration, attendee counts, and call stats.

list_sessions

List all sites (organizational units or locations) for the institution. Returns site names, descriptions, and associated user/event counts.

list_sites

List users in your institution with optional pagination and filters. Returns paginated user profiles including name, email, role, and site associations. Scope: results are STRICTLY limited to your own institution. This tool never returns guest users, users belonging to other institutions, or users who are merely associated with your Spaces/sites — only accounts whose institution is yours. The `filterSites` option only narrows within your institution; it cannot widen the scope. Counting: by default this returns ALL institution users across every role (including Students) and does not exclude disabled/archived accounts, so the total can be larger than a staff-only or active-only dashboard view. Use `filterRoles` (e.g. ["Teacher", "InstitutionAdmin"]) to narrow, and read the `total` field of the response for an exact count rather than inferring it from other endpoints (e.g. list_sites).

list_users

RSVP to an event on behalf of a user, with an optional note. Overwrites the user's previous RSVP status for the event. Requires an explicit write opt-in.

rsvp_event

Rename a custom attribute's key (its display name). The new name applies everywhere the attribute is used. Requires an explicit write opt-in.

rename_attribute_key

Save or replace the institution's webhook configuration: the endpoint URL where webhook events are delivered and the signing secret used to verify request authenticity. Overwrites any existing configuration. Requires an explicit write opt-in.

save_webhook_config

Set weekly recurring availability slots for a user. Replaces ALL existing slots with the provided ones. Requires an explicit write opt-in.

set_user_availability

Add new values to a custom attribute and/or rename existing values. Renamed values change everywhere they are used; added values are appended. Requires an explicit write opt-in.

update_attribute_values

Update an existing cohort's name, organizers, or attendees within a program. Provided lists replace the existing ones. Requires an explicit write opt-in.

update_cohort

Update an existing event. Upcoming events accept title, description, customAttributes, attendees, organizers, type, spaceId, and location; past or cancelled events accept only title, description, and customAttributes. Event times cannot be changed through this tool. May notify newly added attendees. Requires an explicit write opt-in.

update_event

Update attendance status for a user in a past event. Sets the user's status to Present, Late, Absent, Left, or Excuse. Requires institution admin permissions and an explicit write opt-in.

update_attendance

Update an existing program's name, description, or date range. Requires an explicit write opt-in.

update_program

Update an existing program cancellation's name or dates. Only allowed for draft or ready-to-publish programs (not published). Providing start without end makes it single-day; end cannot be provided without start. Requires an explicit write opt-in.

update_program_cancellation