Skip to main content
Glama
ClassQuill MCP server

ClassQuill MCP server

by EquateItAu

ClassQuill MCP server

Give any MCP-aware AI tool — Claude, Codex, Cursor, Windsurf, Composio, and more — read access to your ClassQuill tutoring-business data: sessions, students, tutors, parents, invoices, payments, lesson plans, bookings, earnings, and reports.

It's a thin, read-only proxy over the ClassQuill public API (/v1). Each tool maps 1:1 to a public API endpoint, so the tool list can never drift from the real API. Your credentials never leave your machine (or, in hosted mode, your request).

ClassQuill is the tutoring-business-management platform by EquateIt. The npm package is published as equateit-mcp.

Two ways to use it

Point any remote-MCP client at the hosted server:

https://mcp.classquill.com/mcp
  • Claude / Claude.ai — add it as a custom connector and sign in (OAuth).

  • Codex — codex mcp add classquill --url https://mcp.classquill.com/mcp

  • Any client — pass your API key as a Bearer token: Authorization: Bearer ei_live_…

2. Local (run it yourself via npx)

npx -y equateit-mcp        # stdio, reads EQUATEIT_API_KEY

Claude Code:

claude mcp add classquill -e EQUATEIT_API_KEY=ei_live_xxxx -- npx -y equateit-mcp

Cursor / Claude Desktop / Windsurf (mcpServers config):

{
  "mcpServers": {
    "classquill": {
      "command": "npx",
      "args": ["-y", "equateit-mcp"],
      "env": { "EQUATEIT_API_KEY": "ei_live_xxxx" }
    }
  }
}

Related MCP server: FoxTrove Voice MCP Server

Getting an API key

Create one in the ClassQuill app under Settings → Developers (org admins). Keys look like ei_live_… and are read-only for this server.

Tools

One read-only tool per /v1 GET route — sessions, students, tutors, parents, invoices, payments, lesson-plans, homework, questions, subjects, files, results, availabilities, coverage, reports, and more. The list is generated from the public OpenAPI spec (npm run gen:tools) so it always matches the live API.

Options & environment

Flag

Env var

Default

Purpose

--key

EQUATEIT_API_KEY

—

Your ei_live_… key (stdio mode).

--http

—

off

Run as an HTTP (Streamable HTTP) server instead of stdio.

--port / -p

MCP_PORT

3000

HTTP port.

—

EQUATEIT_API_BASE_URL

https://api.classquill.com

API base (no trailing /v1).

In HTTP mode, each request supplies its own credential as Authorization: Bearer … — an ei_live_… API key or an OAuth access token.

Develop

npm install
npm run build     # → dist/
npm test          # unit tests (url builder + auth scheme)

Self-hosting the HTTP server is a single container — see Dockerfile.

License

MIT — see LICENSE.

Available Tools

59 tools
coverage_gapsD
Read-onlyIdempotent
Inspect

Coverage Gaps

Inputs: limit, subject, min_tutors. Returns: data, meta

coverage_summaryC
Read-onlyIdempotent
Inspect

Coverage Summary

Inputs: subject, postcode. Returns: Counts for /v1/coverage/summary. `covering_area` is the subset of `total` withi…

coverage_tutorsD
Read-onlyIdempotent
Inspect

Coverage Tutors

Inputs: mode, limit, offset, subject, +2 more. Returns: data, meta

get_availabilityC
Read-onlyIdempotent
Inspect

Get Availability

Inputs: availability_id (required). Returns: A tutor's recurring weekly availability rule. `day_of_week` is 0–6 (Sunday=0).

get_blog_postC
Read-onlyIdempotent
Inspect

Get Blog Post

Inputs: post_id (required). Returns: A blog post row returned by /v1/blog-posts. `target` is derived from organizati…

get_classroomC
Read-onlyIdempotent
Inspect

Get Classroom

Inputs: classroom_id (required). Returns: id, name, group_id, tutor_id, +6 more

get_invoiceC
Read-onlyIdempotent
Inspect

Get Invoice

Inputs: invoice_id (required). Returns: id, status, paid_at, sent_at, +9 more

get_leadD
Read-onlyIdempotent
Inspect

Get Lead

Inputs: lead_id (required). Returns: An inbound lead captured by an org lead form. The free-form `payload` is NOT ex…

get_lesson_participantD
Read-onlyIdempotent
Inspect

Get Lesson Participant

Inputs: participant_id (required). Returns: A per-student attendance row on a (group/classroom) session. Billing-state fiel…

get_locationC
Read-onlyIdempotent
Inspect

Get Location

Inputs: location_id (required). Returns: A saved location owned by the org, one of its tutors, or one of its students. `…

get_meC
Read-onlyIdempotent
Inspect

Get Me

Inputs: no named parameters. Returns: org_id, scopes, org_name, org_slug

get_parentC
Read-onlyIdempotent
Inspect

Get Parent

Inputs: parent_id (required). Returns: id, email, status, last_name, +4 more

get_paymentC
Read-onlyIdempotent
Inspect

Get Payment

Inputs: payment_id (required). Returns: id, status, currency, tutor_id, +7 more

get_payoutC
Read-onlyIdempotent
Inspect

Get Payout

Inputs: payout_id (required). Returns: A completed tutor payout (wage-payment ledger). Notification-plumbing columns (…

get_resultD
Read-onlyIdempotent
Inspect

Get Result

Inputs: result_id (required). Returns: id, mode, grade, status, +6 more

get_sessionC
Read-onlyIdempotent
Inspect

Get Session

Inputs: session_id (required). Returns: id, mode, title, status, +11 more

get_studentC
Read-onlyIdempotent
Inspect

Get Student

Inputs: student_id (required). Returns: id, email, status, last_name, +4 more

get_student_groupC
Read-onlyIdempotent
Inspect

Get Student Group

Inputs: group_id (required). Returns: id, name, color, tutor_id, +7 more

get_tutorD
Read-onlyIdempotent
Inspect

Get Tutor

Inputs: tutor_id (required). Returns: id, bio, role, email, +23 more

list_adjustmentsC
Read-onlyIdempotent
Inspect

List Adjustments

Inputs: to, from, limit, offset, +2 more. Returns: data, meta

list_availabilitiesC
Read-onlyIdempotent
Inspect

List Availabilities

Inputs: limit, offset, tutor_id, day_of_week. Returns: data, meta

list_blog_postsC
Read-onlyIdempotent
Inspect

List Blog Posts

Inputs: brand, limit, offset, status, +1 more. Returns: items

list_booking_requestsC
Read-onlyIdempotent
Inspect

List Booking Requests

Inputs: limit, offset, status, subject_id. Returns: data, meta

list_classroomsC
Read-onlyIdempotent
Inspect

List Classrooms

Inputs: limit, offset, subject_id. Returns: data, meta

list_conversation_messagesC
Read-onlyIdempotent
Inspect

List Conversation Messages

Inputs: conversation_id (required), limit, since, offset. Returns: data, meta

list_conversationsC
Read-onlyIdempotent
Inspect

List Conversations

Inputs: type, limit, offset. Returns: data, meta

list_expensesC
Read-onlyIdempotent
Inspect

List Expenses

Inputs: to, from, limit, offset, +3 more. Returns: data, meta

list_filesC
Read-onlyIdempotent
Inspect

List Files

Inputs: limit, scope, offset, resource_type. Returns: data, meta

list_homeworkC
Read-onlyIdempotent
Inspect

List Homework

Inputs: limit, scope, offset, student_id, +1 more. Returns: data, meta

list_invoicesC
Read-onlyIdempotent
Inspect

List Invoices

Inputs: to, from, limit, offset, +2 more. Returns: data, meta

list_leadsC
Read-onlyIdempotent
Inspect

List Leads

Inputs: to, from, limit, offset, +2 more. Returns: data, meta

list_lesson_participantsC
Read-onlyIdempotent
Inspect

List Lesson Participants

Inputs: limit, offset, status, attendance, +2 more. Returns: data, meta

list_lesson_plansC
Read-onlyIdempotent
Inspect

List Lesson Plans

Inputs: limit, scope, offset, status, +1 more. Returns: data, meta

list_locationsC
Read-onlyIdempotent
Inspect

List Locations

Inputs: limit, offset, tutor_id, owner_type, +1 more. Returns: data, meta

list_mileageD
Read-onlyIdempotent
Inspect

List Mileage

Inputs: to, from, limit, offset, +2 more. Returns: data, meta

list_org_inboxC
Read-onlyIdempotent
Inspect

List Org Inbox

Inputs: limit, offset, status. Returns: data, meta

list_parentsC
Read-onlyIdempotent
Inspect

List Parents

Inputs: limit, offset. Returns: data, meta

list_paymentsC
Read-onlyIdempotent
Inspect

List Payments

Inputs: to, from, limit, offset, +3 more. Returns: data, meta

list_payoutsC
Read-onlyIdempotent
Inspect

List Payouts

Inputs: to, from, limit, offset, +1 more. Returns: data, meta

list_questionsC
Read-onlyIdempotent
Inspect

List Questions

Inputs: limit, topic, offset, source, +1 more. Returns: data, meta

list_rate_bandsC
Read-onlyIdempotent
Inspect

List Rate Bands

Inputs: limit, offset. Returns: data, meta

list_rate_cellsC
Read-onlyIdempotent
Inspect

List Rate Cells

Inputs: limit, offset, band_id, subject_id, +3 more. Returns: data, meta

list_resultsC
Read-onlyIdempotent
Inspect

List Results

Inputs: to, from, mode, limit, +3 more. Returns: data, meta

list_session_feedbackC
Read-onlyIdempotent
Inspect

List Session Feedback

Inputs: limit, offset, tutor_id, anonymize, +1 more. Returns: data, meta

list_sessionsC
Read-onlyIdempotent
Inspect

List Sessions

Inputs: to, from, limit, offset, +3 more. Returns: data, meta

list_student_groupsC
Read-onlyIdempotent
Inspect

List Student Groups

Inputs: limit, offset, subject_id, classroom_id. Returns: data, meta

list_studentsC
Read-onlyIdempotent
Inspect

List Students

Inputs: limit, offset. Returns: data, meta

list_subjectsA
Read-onlyIdempotent
Inspect

List Subjects

Inputs: no named parameters. Returns: `/v1/subjects` returns just `{ "data": [...] }` (no pagination).

list_tutor_reviewsC
Read-onlyIdempotent
Inspect

List Tutor Reviews

Inputs: tutor_id (required), limit, offset, anonymize. Returns: data, meta

list_tutorsC
Read-onlyIdempotent
Inspect

List Tutors

Inputs: limit, offset, is_published. Returns: data, meta

list_tutor_tiersC
Read-onlyIdempotent
Inspect

List Tutor Tiers

Inputs: limit, offset. Returns: data, meta

lookup_userC
Read-onlyIdempotent
Inspect

Lookup User

Inputs: email, phone. Returns: GET /v1/users — a user (staff or org-affiliated student/parent) matched by emai…

parent_balanceC
Read-onlyIdempotent
Inspect

Parent Balance

Inputs: parent_id (required). Returns: parent_id, total_paid_cents, outstanding_cents, open_invoices_count, +1 more

pingD
Read-onlyIdempotent
Inspect

Ping

Inputs: no named parameters. Returns: org_id, status, org_name

recommend_tutorsC
Read-onlyIdempotent
Inspect

Recommend Tutors

Inputs: request_id (required), limit. Returns: data, request_id, subject_id

reports_summaryD
Read-onlyIdempotent
Inspect

Reports Summary

Inputs: no named parameters. Returns: active_tutors, sessions_today, active_students, outstanding_cents, +2 more

tutor_available_slotsD
Read-onlyIdempotent
Inspect

Tutor Available Slots

Inputs: to (required), from (required), tutor_id (required), duration. Returns: GET /v1/tutors/{tutor_id}/available-slots — free slots in the window, computed…

tutor_earningsC
Read-onlyIdempotent
Inspect

Tutor Earnings

Inputs: tutor_id (required), to, from. Returns: tutor_id, period_end, earned_cents, period_start, +3 more

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2/5.0

    Scored across 59 tools

    Disambiguation4/5

    Most tools follow a clear resource-oriented pattern (list_<entity>, get_<entity>), so list_students and get_student are easy to distinguish. However, a few overlapping concepts like coverage_tutors/coverage_summary/coverage_gaps and tutor_available_slots/list_availabilities could cause occasional misselection.

    Naming Consistency3/5

    The dominant list_ and get_ prefix pattern is consistent and readable, but several tools deviate with noun-first or action-style names such as tutor_earnings, parent_balance, org_join_link, and coverage_summary. All names use snake_case, which keeps the overall set predictable despite the mixed conventions.

    Tool Count1/5

    With 59 tools, this server far exceeds the reasonable scope for a focused MCP toolset and crosses the 50+ extreme threshold. Many tools are simple list/get pairs for niche resources like mileage, rate_cells, and blog_posts, making the set feel like an exhaustive read model rather than a curated tool surface.

    Completeness1/5

    The toolset is almost entirely read-only: there are no create, update, or delete operations for students, sessions, payments, invoices, or any other domain entity. This severely limits an agent's ability to perform basic tutoring-management workflows, leaving obvious lifecycle gaps.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers