# Teachworks MCP by usefulapi (io.usefulapi/teachworks): tool descriptions scored

- tools/list taken: 2026-11-02 (UTC)
- From: [Official MCP Registry](https://registry.modelcontextprotocol.io/v0/servers/io.usefulapi%2Fteachworks/versions/latest)
- Connected to: https://teachworks.usefulapi.io/mcp
- Homepage: https://usefulapi.io/teachworks/
- Repository: https://github.com/m190/usefulapi-mcp
- Scoring rules: v2
- Tools: 24
- Average: 44.7 / 100 (Cloudy)
- Near-identical pairs: 0

This page shows how Teachworks MCP by usefulapi (io.usefulapi/teachworks)'s tool descriptions scored, the issues found and the names of its tools and parameters. The descriptions are the server's own: read them where the copy came from.

Forecall asked the URL this server lists in the official MCP Registry for its tools/list once, on the date above, without calling any tool. The server may have changed since.

## Across the server

No server-wide issues.

## Tools

- `teachworks_create_child_student`: 33 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Major: Arguments without a description: first_name, last_name, email, mobile_phone, school, grade, birth_date, start_date, status, default_location_id, additional_notes.
  - Minor: String arguments with no constraint or example: email, mobile_phone, school, grade, additional_notes.
  - Minor: The description mentions none of its 3 or more arguments.
  - Minor: Says nothing about what it returns.
  - Minor: Required identifiers whose description does not say where the value comes from: customer_id. Name the tool or the place that returns it, or models look it up first.
- `teachworks_list_employees`: 35 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: Arguments without a description: city, state, zip, status.
  - Minor: String arguments with no constraint or example: email, city, state, zip.
  - Minor: No `required` list, so every argument is optional.
  - Minor: Says nothing about what it returns.
- `teachworks_list_locations`: 37 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: String arguments with no constraint or example: name.
  - Minor: No `required` list, so every argument is optional.
  - Minor: The description mentions none of its 3 or more arguments.
  - Minor: Says nothing about what it returns.
- `teachworks_list_subjects`: 37 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: No `required` list, so every argument is optional.
  - Minor: The description mentions none of its 3 or more arguments.
  - Minor: Says nothing about what it returns.
- `teachworks_create_family`: 38 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Major: Arguments without a description: mobile_phone, home_phone, address, city, state, zip, country, additional_notes.
  - Minor: String arguments with no constraint or example: mobile_phone, home_phone, address, city, state, zip, country, additional_notes.
  - Minor: The description mentions none of its 3 or more arguments.
  - Minor: Says nothing about what it returns.
- `teachworks_list_students`: 40 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: Arguments without a description: status.
  - Minor: String arguments with no constraint or example: email, school, grade, subject.
  - Minor: No `required` list, so every argument is optional.
  - Minor: Says nothing about what it returns.
- `teachworks_list_customers`: 41 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: Arguments without a description: city, state, zip, country, status.
  - Minor: String arguments with no constraint or example: email, city, state, zip, country.
  - Minor: No `required` list, so every argument is optional.
- `teachworks_get_employee_earnings`: 44 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: Says nothing about what it returns.
  - Minor: Required identifiers whose description does not say where the value comes from: employee_id. Name the tool or the place that returns it, or models look it up first.
- `teachworks_list_availabilities`: 44 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: No `required` list, so every argument is optional.
  - Minor: Says nothing about what it returns.
- `teachworks_list_other_events`: 44 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: No `required` list, so every argument is optional.
  - Minor: The description mentions none of its 3 or more arguments.
  - Minor: Says nothing about what it returns.
- `teachworks_list_payments`: 44 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: No `required` list, so every argument is optional.
  - Minor: The description mentions none of its 3 or more arguments.
  - Minor: Says nothing about what it returns.
- `teachworks_list_lessons`: 45 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: Arguments without a description: status.
  - Minor: No `required` list, so every argument is optional.
  - Minor: Says nothing about what it returns.
- `teachworks_create_payment`: 47 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: Arguments without a description: payment_method.
  - Minor: The description mentions none of its 3 or more arguments.
  - Minor: Says nothing about what it returns.
- `teachworks_get_customer`: 47 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: Says nothing about what it returns.
  - Minor: Required identifiers whose description does not say where the value comes from: customer_id. Name the tool or the place that returns it, or models look it up first.
- `teachworks_get_invoice`: 47 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: Says nothing about what it returns.
  - Minor: Required identifiers whose description does not say where the value comes from: invoice_id. Name the tool or the place that returns it, or models look it up first.
- `teachworks_get_lesson_totals`: 47 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: Says nothing about what it returns.
  - Minor: Required identifiers whose description does not say where the value comes from: id. Name the tool or the place that returns it, or models look it up first.
- `teachworks_get_payment`: 47 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: Says nothing about what it returns.
  - Minor: Required identifiers whose description does not say where the value comes from: payment_id. Name the tool or the place that returns it, or models look it up first.
- `teachworks_get_student`: 47 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: Says nothing about what it returns.
  - Minor: Required identifiers whose description does not say where the value comes from: student_id. Name the tool or the place that returns it, or models look it up first.
- `teachworks_list_services`: 49 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: String arguments with no constraint or example: name.
  - Minor: No `required` list, so every argument is optional.
  - Minor: The description mentions none of its 3 or more arguments.
  - Minor: Says nothing about what it returns.
- `teachworks_get_employee`: 50 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: Says nothing about what it returns.
  - Minor: Required identifiers whose description does not say where the value comes from: employee_id. Name the tool or the place that returns it, or models look it up first.
- `teachworks_get_lesson`: 50 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: Says nothing about what it returns.
  - Minor: Required identifiers whose description does not say where the value comes from: lesson_id. Name the tool or the place that returns it, or models look it up first.
- `teachworks_list_invoices`: 51 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: Arguments without a description: status.
  - Minor: No `required` list, so every argument is optional.
  - Minor: Says nothing about what it returns.
- `teachworks_add_student_to_lesson`: 52 / 100
  - Minor: Says nothing about what it returns.
  - Minor: Required identifiers whose description does not say where the value comes from: lesson_id, student_id. Name the tool or the place that returns it, or models look it up first.
- `teachworks_create_lesson`: 57 / 100
  - Minor: Arguments without a description: description.
  - Minor: String arguments with no constraint or example: description.
  - Minor: The description mentions none of its 3 or more arguments.
  - Minor: Says nothing about what it returns.
  - Minor: Required identifiers whose description does not say where the value comes from: employee_id, student_ids, service_id. Name the tool or the place that returns it, or models look it up first.

Is your server listed here and you would rather it were not? Email support@forecall.dev, and we will take it off within 7 days.

[All scored servers](https://forecall.dev/en/servers)