Teachworks MCP by usefulapi

WRITE: add a student to an existing lesson (the lesson must still be Scheduled). PUT /lessons/{id}/add_student.

WRITE: create a child student under an existing family (the family is billed for their lessons). POST /students.

WRITE: create a family customer (the billed parent profile that child students belong to). Add children afterwards with teachworks_create_child_student. POST /customers/family.

WRITE: schedule a single lesson on the calendar for one or more students with a teacher, service and location. Check teachworks_list_availabilities and teachworks_list_lessons first to avoid conflicts. POST /lessons.

WRITE: record a payment received from a customer (bookkeeping only — it does not charge a card). POST /payments.

Retrieve one customer (family or independent student) with contact details and custom fields. GET /customers/{id}.

Retrieve one employee (teacher or staff): contact details, subjects, wage type, bio, permissions. GET /employees/{id}.

Total earnings of one employee (lessons, other events, other compensation, total) for an optional lesson status and date range. GET /employees/{id}/earnings.

Retrieve one invoice with its line items (lessons, charges), taxes and totals. GET /invoices/{id}.

Retrieve one lesson with its participants (students, statuses, charges, notes), teacher, wage and cost. GET /lessons/{id}.

Lesson totals for one student, customer or employee: count (default), duration in minutes, or (employees only) earnings, broken down by status, for an optional status and date range. GET /{students|customers|employees}/{id}/lesson_totals.

Retrieve one payment with its refunds and the invoices it is allocated to. GET /payments/{id}.

Retrieve one student profile: contact details, school/grade, billing, custom fields, default teachers/services. GET /students/{id}.

List teachers' weekly availability slots (day of week + start/end time). Use before scheduling a lesson. GET /availabilities.

List or search customers — the billed profiles: families (with child students) and independent students. Returns contact details, status and last invoice date. GET /customers.

List or search employees — teachers/tutors and administrative staff — with subjects, status and wage settings. GET /employees.

List invoices with customer, number, dates, status (Saved, Approved, Paid, Void) and totals. Filter by customer, status, invoice date or due date range. GET /invoices.

List lessons (the calendar) with teacher, service, location, start/end, duration, status and participants. Filter by teacher, student, location, service, status and date range. GET /lessons.

List locations and sub-locations (rooms) where lessons take place. GET /locations.

List non-lesson calendar events (meetings, open houses, staff work) with location, times and participants. GET /other_events.

List customer payments (amount, method, date, refunds, invoice allocations). Filter by customer and date range. GET /payments.

List services (lesson types such as 'Math Tutoring') with their default cost and wage. GET /services.

List or search students (child students of families and independent students) with their school, grade, subjects, status, billing method and default teachers. GET /students.

List standard subjects (used on student and teacher profiles). GET /subjects.