Skip to content

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.

Tools: 5 delete, 0 irreversible, 0 write, 19 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.

The remote endpoint did not answer the last look

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

  1. 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.

  1. 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/mcp
claude mcp add --transport http teachworks https://teachworks.usefulapi.io/mcp

Run 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.

.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.xml

An Atom feed. Works in any feed reader or Slack's RSS app.

Badge

Anlyon Radar badge for io.usefulapi/teachworks
[![Anlyon Radar](https://radar.anlyon.com/badge/io.usefulapi/teachworks.svg)](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.