mcpField
T
Teachworks MCP by usefulapi

Teachworks MCP by usefulapi

Remote
usefulapi.ioBusiness & Marketing0Updated today

About Teachworks MCP by usefulapi

Teachworks MCP by usefulapi is a hosted MCP server for tutoring businesses and their staff. It lets MCP clients inspect teaching and financial records, book lessons, and create selected records such as families, students, lessons, and payments.

Key features

  1. 01Look up students, families, and employees
  2. 02Review lessons, availability, and events
  3. 03Read invoices and payment records
  4. 04Create families, students, and lessons
  5. 05Add students to lessons and record payments

Use cases

  1. 01Check students and their lesson schedules
  2. 02Review invoice and payment details
  3. 03Create a lesson and add a student

MCP support

It provides a hosted MCP server for clients such as Claude and Cursor. Clients use a Teachworks API token to access read-only tools and selected write tools.

Configuration

Remote servers need no local install. Pick your client, then copy the config or install in one click.

Endpointhttps://teachworks.usefulapi.io/mcp
Copy install command
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.

Tools

24
ParameterTypeRequiredDescription
pageintegerNoPage number (1-based, default 1).
typeenumNofamily = child students, independent = independent students.family | independent
emailstringNoSearch by email.
gradestringNoSearch by grade.
schoolstringNoSearch by school.
statusenumNoActive | Inactive | Prospective
subjectstringNoSearch by subject.
per_pageintegerNoRecords per page (default 20, max 50).
directionenumNoSort by id ascending (default) or descending (newest first).asc | desc
last_namestringNoSearch by last name.
first_namestringNoSearch by first name.
customer_idanyNoOnly students of this customer/family id.
phone_numberstringNoSearch by phone number.

Details

From the project README

Teachworks MCP by usefulapi

Use Teachworks from Claude, Cursor, or any MCP client — read Teachworks students, families, tutors, lessons, invoices and payments; book lessons. Hosted, no local install: connect with your own Teachworks credentials.

Live endpoint: https://teachworks.usefulapi.io/mcp · Homepage: https://usefulapi.io/teachworks

Connect

  • Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://teachworks.usefulapi.io/mcp.
  • Claude Code: claude mcp add --transport http teachworks https://teachworks.usefulapi.io/mcp, then run /mcp to log in.
  • VS Code: Add to VS Code.
  • Cursor and other clients: add the URL as a remote MCP server:
{
  "mcpServers": {
    "teachworks": {
      "url": "https://teachworks.usefulapi.io/mcp"
    }
  }
}

Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your Teachworks credentials.

Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/teachworks/

On first connect you'll provide your Teachworks API token. Your credentials are validated, stored per-user, and scoped to you — no keys in config files.

Tools

ToolTypeWhat it does
teachworks_list_studentsreadList students
teachworks_get_studentreadGet student
teachworks_list_customersreadList customers
teachworks_get_customerreadGet customer
teachworks_list_employeesreadList employees
teachworks_get_employeereadGet employee
teachworks_get_employee_earningsreadGet employee earnings
teachworks_get_lesson_totalsreadGet lesson totals
teachworks_list_lessonsreadList lessons
teachworks_get_lessonreadGet lesson
teachworks_list_other_eventsreadList other events
teachworks_list_availabilitiesreadList teacher availability
teachworks_list_invoicesreadList invoices
teachworks_get_invoicereadGet invoice
teachworks_list_paymentsreadList payments
teachworks_get_paymentreadGet payment
teachworks_list_locationsreadList locations
teachworks_list_servicesreadList services
teachworks_list_subjectsreadList subjects
teachworks_create_familywriteCreate family
teachworks_create_child_studentwriteCreate child student
teachworks_create_lessonwriteCreate lesson
teachworks_add_student_to_lessonwriteAdd student to lesson
teachworks_create_paymentwriteRecord payment
teachworks_usage_statusmetaUsage status (free-tier meter)
teachworks_request_featuremetaRequest a missing feature
teachworks_upgrademetaUpgrade to Pro (unlimited*)
teachworks_cancel_subscriptionmetaCancel the Pro subscription

read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.

Pricing

PlanPriceLimit
Free$050 tool calls / month
Pro (per user)$9/mo or $90/yr (2 months free)Unlimited*

*Pro has a fair use limit of 10,000 tool calls a month on this server. For more, write to [email protected].

Pro covers this server only. Subscribe with teachworks_upgrade (it returns a Stripe Checkout link). Cancel any time with teachworks_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running teachworks_upgrade before then undoes the cancel. Or write to [email protected].

License

MIT © usefulapi. Not affiliated with or endorsed by Teachworks.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.