Teachworks MCP by usefulapi
io.usefulapi/teachworksusefulapi.iostreamable-httpv1.31.4Scanned
Read Teachworks students, families, tutors, lessons, invoices and payments; book lessons.
24 tools: 5 can delete or cancel things and 19 only read.
- Reads private data · 6
- Reads text others write · 5
- Can send data out · 0
- No findings
The remote endpoint did not answer the last look. Remote posture
Anlyon alternative
5 of these tools change something. Run those as governed actions.
Declare what an action changes, and Anlyon puts it under a shared limit, binds every approval to the exact request, and grades the outcome. It works on any HTTPS API you can describe as an action.
Anlyon Radar does not run, proxy or govern this MCP server. A tool your own code calls directly is not routed through Anlyon and is not governed by it.
Import an OpenAPI spec →What the Teachworks MCP by usefulapi can do
The Teachworks MCP by usefulapi is published by usefulapi.io, a domain the MCP Registry verified. It has 24 tools. It can delete or cancel things (5 tools: teachworks_create_family, teachworks_create_child_student, teachworks_create_lesson, teachworks_add_student_to_lesson and 1 more). 19 tools only read.
6 tools read private data (teachworks_get_student, teachworks_get_customer, teachworks_get_employee and 3 more); 5 tools bring in text other people can write (teachworks_create_family, teachworks_create_child_student, teachworks_create_lesson and 2 more).
None of the fixed checks matched anything in its tool definitions. That is not a safety guarantee.
Last scanned Oct 25, 2026, version 1.31.4.
Tools
Grouped by what each tool does, most consequential first. Open one for its reasons and full description; descriptions are the publisher's own words.
24 tools
Deletes or cancels 5Claude Code: deny
teachworks_add_student_to_lessonWRITE: add a student to an existing lesson (the lesson must still be Scheduled).Reads text others writeNo findings
Why it is in this group
- The name "teachworks_add_student_to_lesson" says "add": a word for a change.
- The server marks it destructive (destructiveHint: true).
What it can reach
- untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
Description, as the server wrote it WRITE: add a student to an existing lesson (the lesson must still be Scheduled). PUT /lessons/{id}/add_student.
Annotations the server declares
- title: Add student to lesson
- readOnlyHint: false
- destructiveHint: true
- idempotentHint: false
- openWorldHint: true
teachworks_create_child_studentWRITE: create a child student under an existing family (the family is billed for their lessons).Reads text others writeNo findings
Why it is in this group
- The name "teachworks_create_child_student" says "create": a word for a change.
- The server marks it destructive (destructiveHint: true).
What it can reach
- untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
Description, as the server wrote it WRITE: create a child student under an existing family (the family is billed for their lessons). POST /students.
Annotations the server declares
- title: Create child student
- readOnlyHint: false
- destructiveHint: true
- idempotentHint: false
- openWorldHint: true
teachworks_create_familyWRITE: create a family customer (the billed parent profile that child students belong to).Reads text others writeNo findings
Why it is in this group
- The name "teachworks_create_family" says "create": a word for a change.
- The server marks it destructive (destructiveHint: true).
What it can reach
- untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
Description, as the server wrote it 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.
Annotations the server declares
- title: Create family
- readOnlyHint: false
- destructiveHint: true
- idempotentHint: false
- openWorldHint: true
teachworks_create_lessonWRITE: schedule a single lesson on the calendar for one or more students with a teacher, service and location.Reads text others writeNo findings
Why it is in this group
- The name "teachworks_create_lesson" says "create": a word for a change.
- The server marks it destructive (destructiveHint: true).
What it can reach
- untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
Description, as the server wrote it 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.
Annotations the server declares
- title: Create lesson
- readOnlyHint: false
- destructiveHint: true
- idempotentHint: false
- openWorldHint: true
teachworks_create_paymentWRITE: record a payment received from a customer (bookkeeping only — it does not charge a card).Reads text others writeNo findings
Why it is in this group
- The name "teachworks_create_payment" says "create": a word for a change.
- The name "teachworks_create_payment" also says "payment": a word that usually means money moves, which cannot be taken back.
- The server marks it destructive (destructiveHint: true).
What it can reach
- untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
Description, as the server wrote it WRITE: record a payment received from a customer (bookkeeping only — it does not charge a card). POST /payments.
Annotations the server declares
- title: Record payment
- readOnlyHint: false
- destructiveHint: true
- idempotentHint: false
- openWorldHint: true
Only reads 19Show 19 read-only tools
teachworks_get_customerRetrieve one customer (family or independent student) with contact details and custom fields.Reads private dataNo findings
Why it is in this group
- The name "teachworks_get_customer" says "get": a word for reading.
What it can reach
- private-dataThe description's first sentence says "retrieve" and "contact": it reads contacts.
Description, as the server wrote it Retrieve one customer (family or independent student) with contact details and custom fields. GET /customers/{id}.
Annotations the server declares
- title: Get customer
- readOnlyHint: true
teachworks_get_employeeRetrieve one employee (teacher or staff): contact details, subjects, wage type, bio, permissions.Reads private dataNo findings
Why it is in this group
- The name "teachworks_get_employee" says "get": a word for reading.
What it can reach
- private-dataThe description's first sentence says "retrieve" and "contact": it reads contacts.
Description, as the server wrote it Retrieve one employee (teacher or staff): contact details, subjects, wage type, bio, permissions. GET /employees/{id}.
Annotations the server declares
- title: Get employee
- readOnlyHint: true
teachworks_get_employee_earningsTotal earnings of one employee (lessons, other events, other compensation, total) for an optional lesson status and date range.No findings
Why it is in this group
- The name "teachworks_get_employee_earnings" says "get": a word for reading.
Description, as the server wrote it Total earnings of one employee (lessons, other events, other compensation, total) for an optional lesson status and date range. GET /employees/{id}/earnings.
Annotations the server declares
- title: Get employee earnings
- readOnlyHint: true
teachworks_get_invoiceRetrieve one invoice with its line items (lessons, charges), taxes and totals.No findings
Why it is in this group
- The name "teachworks_get_invoice" says "get": a word for reading.
Description, as the server wrote it Retrieve one invoice with its line items (lessons, charges), taxes and totals. GET /invoices/{id}.
Annotations the server declares
- title: Get invoice
- readOnlyHint: true
teachworks_get_lessonRetrieve one lesson with its participants (students, statuses, charges, notes), teacher, wage and cost.Reads private dataNo findings
Why it is in this group
- The name "teachworks_get_lesson" says "get": a word for reading.
What it can reach
- private-dataThe description's first sentence says "retrieve" and "note": it reads notes.
Description, as the server wrote it Retrieve one lesson with its participants (students, statuses, charges, notes), teacher, wage and cost. GET /lessons/{id}.
Annotations the server declares
- title: Get lesson
- readOnlyHint: true
teachworks_get_lesson_totalsLesson 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 rang…No findings
Why it is in this group
- The name "teachworks_get_lesson_totals" says "get": a word for reading.
Description, as the server wrote it 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.
Annotations the server declares
- title: Get lesson totals
- readOnlyHint: true
teachworks_get_paymentRetrieve one payment with its refunds and the invoices it is allocated to.No findings
Why it is in this group
- The name "teachworks_get_payment" says "get": a word for reading.
Description, as the server wrote it Retrieve one payment with its refunds and the invoices it is allocated to. GET /payments/{id}.
Annotations the server declares
- title: Get payment
- readOnlyHint: true
teachworks_get_studentRetrieve one student profile: contact details, school/grade, billing, custom fields, default teachers/services.Reads private dataNo findings
Why it is in this group
- The name "teachworks_get_student" says "get": a word for reading.
What it can reach
- private-dataThe description's first sentence says "retrieve" and "contact": it reads contacts.
Description, as the server wrote it Retrieve one student profile: contact details, school/grade, billing, custom fields, default teachers/services. GET /students/{id}.
Annotations the server declares
- title: Get student
- readOnlyHint: true
teachworks_list_availabilitiesList teachers' weekly availability slots (day of week + start/end time).No findings
Why it is in this group
- The name "teachworks_list_availabilities" says "list": a word for reading.
Description, as the server wrote it List teachers' weekly availability slots (day of week + start/end time). Use before scheduling a lesson. GET /availabilities.
Annotations the server declares
- title: List teacher availability
- readOnlyHint: true
teachworks_list_customersList or search customers — the billed profiles: families (with child students) and independent students.No findings
Why it is in this group
- The name "teachworks_list_customers" says "list": a word for reading.
Description, as the server wrote it List or search customers — the billed profiles: families (with child students) and independent students. Returns contact details, status and last invoice date. GET /customers.
Annotations the server declares
- title: List customers
- readOnlyHint: true
teachworks_list_employeesList or search employees — teachers/tutors and administrative staff — with subjects, status and wage settings.No findings
Why it is in this group
- The name "teachworks_list_employees" says "list": a word for reading.
Description, as the server wrote it List or search employees — teachers/tutors and administrative staff — with subjects, status and wage settings. GET /employees.
Annotations the server declares
- title: List employees
- readOnlyHint: true
teachworks_list_invoicesList invoices with customer, number, dates, status (Saved, Approved, Paid, Void) and totals.No findings
Why it is in this group
- The name "teachworks_list_invoices" says "list": a word for reading.
Description, as the server wrote it 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.
Annotations the server declares
- title: List invoices
- readOnlyHint: true
teachworks_list_lessonsList lessons (the calendar) with teacher, service, location, start/end, duration, status and participants.Reads private dataNo findings
Why it is in this group
- The name "teachworks_list_lessons" says "list": a word for reading.
What it can reach
- private-dataThe description's first sentence says "list" and "calendar": it reads calendars.
Description, as the server wrote it 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.
Annotations the server declares
- title: List lessons
- readOnlyHint: true
teachworks_list_locationsList locations and sub-locations (rooms) where lessons take place.No findings
Why it is in this group
- The name "teachworks_list_locations" says "list": a word for reading.
Description, as the server wrote it List locations and sub-locations (rooms) where lessons take place. GET /locations.
Annotations the server declares
- title: List locations
- readOnlyHint: true
teachworks_list_other_eventsList non-lesson calendar events (meetings, open houses, staff work) with location, times and participants.Reads private dataNo findings
Why it is in this group
- The name "teachworks_list_other_events" says "list": a word for reading.
What it can reach
- private-dataThe description's first sentence says "list" and "calendar": it reads calendars.
Description, as the server wrote it List non-lesson calendar events (meetings, open houses, staff work) with location, times and participants. GET /other_events.
Annotations the server declares
- title: List other events
- readOnlyHint: true
teachworks_list_paymentsList customer payments (amount, method, date, refunds, invoice allocations).No findings
Why it is in this group
- The name "teachworks_list_payments" says "list": a word for reading.
Description, as the server wrote it List customer payments (amount, method, date, refunds, invoice allocations). Filter by customer and date range. GET /payments.
Annotations the server declares
- title: List payments
- readOnlyHint: true
teachworks_list_servicesList services (lesson types such as 'Math Tutoring') with their default cost and wage.No findings
Why it is in this group
- The name "teachworks_list_services" says "list": a word for reading.
Description, as the server wrote it List services (lesson types such as 'Math Tutoring') with their default cost and wage. GET /services.
Annotations the server declares
- title: List services
- readOnlyHint: true
teachworks_list_studentsList or search students (child students of families and independent students) with their school, grade, subjects, status, billing method and default teachers.No findings
Why it is in this group
- The name "teachworks_list_students" says "list": a word for reading.
Description, as the server wrote it List or search students (child students of families and independent students) with their school, grade, subjects, status, billing method and default teachers. GET /students.
Annotations the server declares
- title: List students
- readOnlyHint: true
teachworks_list_subjectsList standard subjects (used on student and teacher profiles).No findings
Why it is in this group
- The name "teachworks_list_subjects" says "list": a word for reading.
Description, as the server wrote it List standard subjects (used on student and teacher profiles). GET /subjects.
Annotations the server declares
- title: List subjects
- readOnlyHint: true
This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.
Exfil surface
Which tools read private data, which read text someone else can write, and which can send data out. One of each is a path a prompt injection can use.
No private-data, untrusted-input, outbound path in this server alone: no tool is tagged outbound.
- Reads private data6
- Reads files, mail, messages, databases, secrets, calendars or repositories.
- Reads text others write5
- Brings in text someone else can write: web pages, inbound email, messages, issues and comments.
- Can send data out0
- Can carry data to people or systems: it sends, posts or publishes, or takes a recipient, channel or URL.
Other servers in the same agent add their own tools to these paths. Audit your whole setup to see them together.
Remote posture
What anyone on the internet sees at the remote endpoint: an anonymous initialize and tools/list, and the public OAuth metadata.
Looked at Nov 20, 2026, 19:38 UTC, unchanged since Oct 29, 2026. No credentials were sent and no tool was called. What is looked at.
- Reachable
- no
- HTTP status of an anonymous initialize
- not observed
- tools/list served without credentials
- no
- Tools that change things, listed without credentials
- 0
- Protocol version
- not observed
- WWW-Authenticate on 401
- not observed
- resource_metadata in WWW-Authenticate
- not observed
- RFC 9728 protected resource metadata
- not observed
- Authorization servers
- not observed
- Legacy HTTP+SSE transport
- no
- Dynamic client registration
- not observed
- Client ID metadata documents
- not observed
The probe stopped: The server redirected a POST to a different request.
Posture changes
- Oct 29, 2026
- Reachable: yes to no
- HTTP status of an anonymous initialize: 200 to none
- tools/list served without credentials: yes to no
- Tools that change things, listed without credentials: 5 to 0
- Protocol version: 2025-06-18 to none
- RFC 9728 protected resource metadata: https://teachworks.usefulapi.io/.well-known/oauth-protected-resource/mcp to none
- Authorization servers: https://teachworks.usefulapi.io to none
- Dynamic client registration: yes to not observed
- Client ID metadata documents: no to not observed
Findings
Matches of fixed checks, with the text they matched.
No check matched anything in these tool definitions. That is not a safety guarantee.
History
Changes to its tool definitions and to its remote endpoint, newest first.
PostureRemote posture changed. Reachable: yes -> no; HTTP status of an anonymous initialize: 200 -> none; tools/list served without credentials: yes -> no (and 6 more).View diff
- Reachable: yes to no
- HTTP status of an anonymous initialize: 200 to none
- tools/list served without credentials: yes to no
- Tools that change things, listed without credentials: 5 to 0
- Protocol version: 2025-06-18 to none
- RFC 9728 protected resource metadata: https://teachworks.usefulapi.io/.well-known/oauth-protected-resource/mcp to none
- Authorization servers: https://teachworks.usefulapi.io to none
- Dynamic client registration: yes to not observed
- Client ID metadata documents: no to not observed
Install
Pinned to version 1.31.4. Values in angle brackets are yours to fill in.
claude mcp add --transport http teachworks https://teachworks.usefulapi.io/mcpclaude mcp add --transport http teachworks https://teachworks.usefulapi.io/mcpRun in a terminal.
Claude Code permissions
Allow the reads, ask before a change or a way out, deny the deletes. Paste into .claude/settings.json.
{
"permissions": {
"allow": [
"mcp__teachworks__teachworks_list_students",
"mcp__teachworks__teachworks_get_student",
"mcp__teachworks__teachworks_list_customers",
"mcp__teachworks__teachworks_get_customer",
"mcp__teachworks__teachworks_list_employees",
"mcp__teachworks__teachworks_get_employee",
"mcp__teachworks__teachworks_get_employee_earnings",
"mcp__teachworks__teachworks_get_lesson_totals",
"mcp__teachworks__teachworks_list_lessons",
"mcp__teachworks__teachworks_get_lesson",
"mcp__teachworks__teachworks_list_other_events",
"mcp__teachworks__teachworks_list_availabilities",
"mcp__teachworks__teachworks_list_invoices",
"mcp__teachworks__teachworks_get_invoice",
"mcp__teachworks__teachworks_list_payments",
"mcp__teachworks__teachworks_get_payment",
"mcp__teachworks__teachworks_list_locations",
"mcp__teachworks__teachworks_list_services",
"mcp__teachworks__teachworks_list_subjects"
],
"ask": [],
"deny": [
"mcp__teachworks__teachworks_create_family",
"mcp__teachworks__teachworks_create_child_student",
"mcp__teachworks__teachworks_create_lesson",
"mcp__teachworks__teachworks_add_student_to_lesson",
"mcp__teachworks__teachworks_create_payment"
]
}
}Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. A read that can send data out (it takes a URL, say) asks first too. It assumes the server is installed as teachworks. Review it before you use it.
Capability tags behind 11 rules
- mcp__teachworks__teachworks_get_student private-data
- mcp__teachworks__teachworks_get_customer private-data
- mcp__teachworks__teachworks_get_employee private-data
- mcp__teachworks__teachworks_list_lessons private-data
- mcp__teachworks__teachworks_get_lesson private-data
- mcp__teachworks__teachworks_list_other_events private-data
- mcp__teachworks__teachworks_create_family untrusted-input
- mcp__teachworks__teachworks_create_child_student untrusted-input
- mcp__teachworks__teachworks_create_lesson untrusted-input
- mcp__teachworks__teachworks_add_student_to_lesson untrusted-input
- mcp__teachworks__teachworks_create_payment untrusted-input
Pin
Keep the decision: fail CI when the tools change, follow every change, or show a badge.
Pin in CI
Fail a build when the tools you reviewed are not the tools the server serves today.
curl -s "https://radar.anlyon.com/api/v1/servers/io.usefulapi/teachworks/verify?hash=dd06d73a714ea3fbf122868c541f888d5ca1dc0bcf9bb6a6d97d3159dab27090" | jq -e '.changed == false'Pinned hash dd06d73a714e, from Oct 25, 2026, 23:20 UTC.
Watch
Get told when its tools change: a new tool, a new description, a new class.
https://radar.anlyon.com/servers/io.usefulapi/teachworks/changes.xmlAn Atom feed. Works in any feed reader or Slack's RSS app.
Badge
[](https://radar.anlyon.com/servers/io.usefulapi/teachworks)Source: MCP Registry · repository. Synced Nov 18, 2026, 11:19 UTC.
Teachworks MCP by usefulapi: questions and answers
Answered from the scan above, not from the publisher's description.
Is the Teachworks MCP by usefulapi safe?
- No scan can promise that. What its definitions show: 24 tools, 5 of which can change, send or delete something, and 0 findings from fixed checks. Allow the reads, ask before each change, and deny the deletes; the permissions block on this page does that.
Can the Teachworks MCP by usefulapi delete data?
- Yes. 5 tools can delete, cancel or revoke something: teachworks_create_family, teachworks_create_child_student, teachworks_create_lesson, teachworks_add_student_to_lesson and teachworks_create_payment.
Can the Teachworks MCP by usefulapi do things that cannot be undone?
- No tool is classed as irreversible: none of them sends, pays, publishes or merges, going by their definitions.
What tools does the Teachworks MCP by usefulapi have?
- 24 tools: 5 destructive, 19 read. teachworks_create_family, teachworks_create_child_student, teachworks_create_lesson, teachworks_add_student_to_lesson, teachworks_create_payment, teachworks_list_students, teachworks_get_student, teachworks_list_customers and 16 more.
Does the Teachworks MCP by usefulapi need sign-in or OAuth?
- Its remote endpoint did not answer the last anonymous look.
Does the Teachworks MCP by usefulapi send data to outside services?
- None of its tools sends, posts or publishes, or takes a recipient, channel or URL.
Has the Teachworks MCP by usefulapi changed its tools?
- Not since Anlyon Radar started tracking it. Last scanned Oct 25, 2026.