Name: Teachworks MCP by usefulapi
Author: usefulapi

Teachworks MCP by usefulapi

Read Teachworks students, families, tutors, lessons, invoices and payments; book lessons.

not scanned Remote · Streamable HTTP No auth needed 24 tools v1.2.1

No reviews yet by usefulapiGitHub The publisher’s own endpoint — this marketplace is not in the path

tools declared

—

trust score

remote

at its publisher

—

calls last 7d

What it does

Read Teachworks students, families, tutors, lessons, invoices and payments; book lessons.

Quickstart

# 1 — add it to Claude Code
claude mcp add --scope user --transport http teachworks-mcp-by-usefulapi https://teachworks.usefulapi.io/mcp

# 2 — ask your agent for something these tools do
#   teachworks_list_students, teachworks_get_student, teachworks_list_customers and 21 more

Teachworks MCP by usefulapi costs nothing on mcprush: there is no plan to choose here, no cap to set and nothing mcprush can bill you for.

Publishernot claimed

usefulapi334 servers

24 categories

All 334 servers

Collected from a public index. Nobody has claimed this account, so nothing here was written by its author — claim it if it is yours.

Tool surface

What the model actually sees. Descriptions are diffed on every release — see version history.

Only tools that write or reach the network

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

Parameter	Type	Required	Notes
customer_id		no	Only students of this customer/family id.
first_name	string	no	Search by first name.
last_name	string	no	Search by last name.
email	string	no	Search by email.
phone_number	string	no	Search by phone number.
school	string	no	Search by school.
grade	string	no	Search by grade.
subject	string	no	Search by subject.
type	string	no	family = child students, independent = independent students.
status	string	no	—
page	integer	no	Page number (1-based, default 1).
per_page	integer	no	Records per page (default 20, max 50).
direction	string	no	Sort by id ascending (default) or descending (newest first).

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

Parameter	Type	Required	Notes
student_id		yes	Student id.

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

Parameter	Type	Required	Notes
first_name	string	no	Search by first name.
last_name	string	no	Search by last name.
email	string	no	Search by email.
phone_number	string	no	Search by phone number.
city	string	no	—
state	string	no	—
zip	string	no	—
country	string	no	—
type	string	no	family or independent.
status	string	no	—
page	integer	no	Page number (1-based, default 1).
per_page	integer	no	Records per page (default 20, max 50).
direction	string	no	Sort by id ascending (default) or descending (newest first).

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

Parameter	Type	Required	Notes
customer_id		yes	Customer id.

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

Parameter	Type	Required	Notes
first_name	string	no	Search by first name.
last_name	string	no	Search by last name.
email	string	no	Search by email.
city	string	no	—
state	string	no	—
zip	string	no	—
status	string	no	—
subject	string	no	Search by subject taught.
page	integer	no	Page number (1-based, default 1).
per_page	integer	no	Records per page (default 20, max 50).
direction	string	no	Sort by id ascending (default) or descending (newest first).

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

Parameter	Type	Required	Notes
employee_id		yes	Employee id.

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

Parameter	Type	Required	Notes
employee_id		yes	Employee id.
status	string	no	Only lessons with this status.
date_from	string	no	Lessons starting on or after this date.
date_to	string	no	Lessons starting on or before this date.

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.

Parameter	Type	Required	Notes
kind	string	yes	Whose lessons to total.
id		yes	The student, customer or employee id.
measure	string	no	count (default), duration (minutes) or earnings (employees only).
status	string	no	Only lessons with this status.
date_from	string	no	Lessons starting on or after this date.
date_to	string	no	Lessons starting on or before this date.

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.

Parameter	Type	Required	Notes
employee_id		no	Only lessons taught by this teacher (employee id).
student_id		no	Only lessons with this student.
location_id		no	Only lessons at this location (exact).
location_or_parent_location_id		no	Lessons at this location or any of its sub-locations.
service_id		no	Only lessons of this service.
series_id		no	Only lessons of this repeating series.
name	string	no	Search by lesson name.
status	string	no	—
custom_status	string	no	Search by custom status (Custom Statuses add-on).
from_date	string	no	Lessons starting on exactly this date.
date_from	string	no	Lessons starting on or after this date.
date_to	string	no	Lessons starting on or before this date.
joinable	boolean	no	true = only lessons marked joinable.
include_deleted	boolean	no	true = include deleted lessons.
page	integer	no	Page number (1-based, default 1).
per_page	integer	no	Records per page (default 20, max 50).
direction	string	no	Sort by id ascending (default) or descending (newest first).

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

Parameter	Type	Required	Notes
lesson_id		yes	Lesson id.

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

Parameter	Type	Required	Notes
employee_id		no	Only events of this employee.
location_id		no	Only events at this location.
series_id		no	Only events of this repeating series.
from_date	string	no	Events starting on exactly this date.
date_from	string	no	Events starting on or after this date.
date_to	string	no	Events starting on or before this date.
page	integer	no	Page number (1-based, default 1).
per_page	integer	no	Records per page (default 20, max 50).
direction	string	no	Sort by id ascending (default) or descending (newest first).

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

Parameter	Type	Required	Notes
employee_id		no	Only this teacher's availability.
day	integer	no	Day of week, Sunday = 0 … Saturday = 6.
page	integer	no	Page number (1-based, default 1).
per_page	integer	no	Records per page (default 20, max 50).
direction	string	no	Sort by id ascending (default) or descending (newest first).

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.

Parameter	Type	Required	Notes
customer_id		no	Only invoices of this customer.
number		no	Invoice number.
status	string	no	—
date_from	string	no	Invoice date on or after.
date_to	string	no	Invoice date on or before.
due_from	string	no	Due date on or after.
due_to	string	no	Due date on or before (e.g. today, to find overdue invoices together with status Approved).
page	integer	no	Page number (1-based, default 1).
per_page	integer	no	Records per page (default 20, max 50).
direction	string	no	Sort by id ascending (default) or descending (newest first).

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

Parameter	Type	Required	Notes
invoice_id		yes	Invoice id.

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

Parameter	Type	Required	Notes
customer_id		no	Only payments of this customer.
date_from	string	no	Payment date on or after.
date_to	string	no	Payment date on or before.
page	integer	no	Page number (1-based, default 1).
per_page	integer	no	Records per page (default 20, max 50).
direction	string	no	Sort by id ascending (default) or descending (newest first).

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

Parameter	Type	Required	Notes
payment_id		yes	Payment id.

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

Parameter	Type	Required	Notes
name	string	no	Search by name.
page	integer	no	Page number (1-based, default 1).
per_page	integer	no	Records per page (default 20, max 50).
direction	string	no	Sort by id ascending (default) or descending (newest first).

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

Parameter	Type	Required	Notes
name	string	no	Search by name.
page	integer	no	Page number (1-based, default 1).
per_page	integer	no	Records per page (default 20, max 50).
direction	string	no	Sort by id ascending (default) or descending (newest first).

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

Parameter	Type	Required	Notes
name	string	no	Search by name (partial match).
page	integer	no	Page number (1-based, default 1).
per_page	integer	no	Records per page (default 20, max 50).
direction	string	no	Sort by id ascending (default) or descending (newest first).

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.

Parameter	Type	Required	Notes
first_name	string	yes	Parent first name(s), e.g. 'Frank & Tina'.
last_name	string	yes	Family last name.
email	string	no	Primary email (notifications, user account).
mobile_phone	string	no	—
home_phone	string	no	—
address	string	no	—
city	string	no	—
state	string	no	—
zip	string	no	—
country	string	no	—
status	string	no	Defaults to Active; use Prospective for leads.
additional_notes	string	no	—

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

Parameter	Type	Required	Notes
customer_id		yes	The family (customer) id the student belongs to.
first_name	string	yes	—
last_name	string	yes	—
email	string	no	—
mobile_phone	string	no	—
school	string	no	—
grade	string	no	—
birth_date	string	no	—
start_date	string	no	—
status	string	no	—
default_location_id		no	—
default_teacher_ids	array	no	Default teacher (employee) ids.
default_service_ids	array	no	Default service ids.
standard_subject_ids	array	no	Subject ids.
additional_notes	string	no	—

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.

Parameter	Type	Required	Notes
employee_id		yes	Teacher (employee) id.
student_ids	array	yes	Student ids attending.
service_id		yes	Service id (sets the default cost and wage).
location_id		no	Location id.
from_date	string	yes	Start date.
from_time	string	yes	Start time, e.g. 16:00.
to_date	string	no	End date (defaults to from_date).
to_time	string	yes	End time, e.g. 17:00.
name	string	no	Lesson name (defaults per Teachworks settings).
description	string	no	—
time_zone	string	no	Rails time zone name, e.g. 'Eastern Time (US & Canada)' (defaults to the account's).
spaces	integer	no	Number of student spaces (group lessons).

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

Parameter	Type	Required	Notes
lesson_id		yes	Lesson id.
student_id		yes	Student id to add.

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

Parameter	Type	Required	Notes
customer_id		yes	Customer that paid.
amount	number	yes	Amount paid.
date	string	yes	Payment date.
payment_method	string	no	—
description	string	no	Details, e.g. 'Payment for INV-0216'.

Free

$0 forever

Every tool — any call limit is its publisher’s, not ours
No card, and mcprush charges nothing for it
Runs at its publisher’s own address — this marketplace is not in the path
Nothing to cap, because mcprush bills nothing

Nothing here is billable: mcprush charges nothing to install Teachworks MCP by usefulapi or to call it, at any volume.

Where are you running it?

Tool surface

Release history

Teachworks MCP by usefulapi

What it does

Quickstart

Where are you running it?

Tool surface

What counts against your monthly calls

Release history

See also