ClassQuill MCP server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@ClassQuill MCP server show my upcoming sessions"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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
1. Hosted (recommended — nothing to install)
Point any remote-MCP client at the hosted server:
https://mcp.classquill.com/mcpClaude / Claude.ai — add it as a custom connector and sign in (OAuth).
Codex —
codex mcp add classquill --url https://mcp.classquill.com/mcpAny 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_KEYClaude Code:
claude mcp add classquill -e EQUATEIT_API_KEY=ei_live_xxxx -- npx -y equateit-mcpCursor / 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 |
|
| — | Your |
| — | off | Run as an HTTP (Streamable HTTP) server instead of stdio. |
|
|
| HTTP port. |
— |
|
| API base (no trailing |
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 toolscoverage_gapsDRead-onlyIdempotentInspect
Coverage Gaps
Inputs: limit, subject, min_tutors. Returns: data, meta
coverage_summaryCRead-onlyIdempotentInspect
Coverage Summary
Inputs: subject, postcode. Returns: Counts for /v1/coverage/summary. `covering_area` is the subset of `total` withi…
coverage_tutorsDRead-onlyIdempotentInspect
Coverage Tutors
Inputs: mode, limit, offset, subject, +2 more. Returns: data, meta
get_availabilityCRead-onlyIdempotentInspect
Get Availability
Inputs: availability_id (required). Returns: A tutor's recurring weekly availability rule. `day_of_week` is 0–6 (Sunday=0).
get_blog_postCRead-onlyIdempotentInspect
Get Blog Post
Inputs: post_id (required). Returns: A blog post row returned by /v1/blog-posts. `target` is derived from organizati…
get_classroomCRead-onlyIdempotentInspect
Get Classroom
Inputs: classroom_id (required). Returns: id, name, group_id, tutor_id, +6 more
get_invoiceCRead-onlyIdempotentInspect
Get Invoice
Inputs: invoice_id (required). Returns: id, status, paid_at, sent_at, +9 more
get_leadDRead-onlyIdempotentInspect
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_participantDRead-onlyIdempotentInspect
Get Lesson Participant
Inputs: participant_id (required). Returns: A per-student attendance row on a (group/classroom) session. Billing-state fiel…
get_locationCRead-onlyIdempotentInspect
Get Location
Inputs: location_id (required). Returns: A saved location owned by the org, one of its tutors, or one of its students. `…
get_meCRead-onlyIdempotentInspect
Get Me
Inputs: no named parameters. Returns: org_id, scopes, org_name, org_slug
get_parentCRead-onlyIdempotentInspect
Get Parent
Inputs: parent_id (required). Returns: id, email, status, last_name, +4 more
get_paymentCRead-onlyIdempotentInspect
Get Payment
Inputs: payment_id (required). Returns: id, status, currency, tutor_id, +7 more
get_payoutCRead-onlyIdempotentInspect
Get Payout
Inputs: payout_id (required). Returns: A completed tutor payout (wage-payment ledger). Notification-plumbing columns (…
get_resultDRead-onlyIdempotentInspect
Get Result
Inputs: result_id (required). Returns: id, mode, grade, status, +6 more
get_sessionCRead-onlyIdempotentInspect
Get Session
Inputs: session_id (required). Returns: id, mode, title, status, +11 more
get_studentCRead-onlyIdempotentInspect
Get Student
Inputs: student_id (required). Returns: id, email, status, last_name, +4 more
get_student_groupCRead-onlyIdempotentInspect
Get Student Group
Inputs: group_id (required). Returns: id, name, color, tutor_id, +7 more
get_tutorDRead-onlyIdempotentInspect
Get Tutor
Inputs: tutor_id (required). Returns: id, bio, role, email, +23 more
list_adjustmentsCRead-onlyIdempotentInspect
List Adjustments
Inputs: to, from, limit, offset, +2 more. Returns: data, meta
list_availabilitiesCRead-onlyIdempotentInspect
List Availabilities
Inputs: limit, offset, tutor_id, day_of_week. Returns: data, meta
list_blog_postsCRead-onlyIdempotentInspect
List Blog Posts
Inputs: brand, limit, offset, status, +1 more. Returns: items
list_booking_requestsCRead-onlyIdempotentInspect
List Booking Requests
Inputs: limit, offset, status, subject_id. Returns: data, meta
list_classroomsCRead-onlyIdempotentInspect
List Classrooms
Inputs: limit, offset, subject_id. Returns: data, meta
list_conversation_messagesCRead-onlyIdempotentInspect
List Conversation Messages
Inputs: conversation_id (required), limit, since, offset. Returns: data, meta
list_conversationsCRead-onlyIdempotentInspect
List Conversations
Inputs: type, limit, offset. Returns: data, meta
list_expensesCRead-onlyIdempotentInspect
List Expenses
Inputs: to, from, limit, offset, +3 more. Returns: data, meta
list_filesCRead-onlyIdempotentInspect
List Files
Inputs: limit, scope, offset, resource_type. Returns: data, meta
list_homeworkCRead-onlyIdempotentInspect
List Homework
Inputs: limit, scope, offset, student_id, +1 more. Returns: data, meta
list_invoicesCRead-onlyIdempotentInspect
List Invoices
Inputs: to, from, limit, offset, +2 more. Returns: data, meta
list_leadsCRead-onlyIdempotentInspect
List Leads
Inputs: to, from, limit, offset, +2 more. Returns: data, meta
list_lesson_participantsCRead-onlyIdempotentInspect
List Lesson Participants
Inputs: limit, offset, status, attendance, +2 more. Returns: data, meta
list_lesson_plansCRead-onlyIdempotentInspect
List Lesson Plans
Inputs: limit, scope, offset, status, +1 more. Returns: data, meta
list_locationsCRead-onlyIdempotentInspect
List Locations
Inputs: limit, offset, tutor_id, owner_type, +1 more. Returns: data, meta
list_mileageDRead-onlyIdempotentInspect
List Mileage
Inputs: to, from, limit, offset, +2 more. Returns: data, meta
list_org_inboxCRead-onlyIdempotentInspect
List Org Inbox
Inputs: limit, offset, status. Returns: data, meta
list_parentsCRead-onlyIdempotentInspect
List Parents
Inputs: limit, offset. Returns: data, meta
list_paymentsCRead-onlyIdempotentInspect
List Payments
Inputs: to, from, limit, offset, +3 more. Returns: data, meta
list_payoutsCRead-onlyIdempotentInspect
List Payouts
Inputs: to, from, limit, offset, +1 more. Returns: data, meta
list_questionsCRead-onlyIdempotentInspect
List Questions
Inputs: limit, topic, offset, source, +1 more. Returns: data, meta
list_rate_bandsCRead-onlyIdempotentInspect
List Rate Bands
Inputs: limit, offset. Returns: data, meta
list_rate_cellsCRead-onlyIdempotentInspect
List Rate Cells
Inputs: limit, offset, band_id, subject_id, +3 more. Returns: data, meta
list_resultsCRead-onlyIdempotentInspect
List Results
Inputs: to, from, mode, limit, +3 more. Returns: data, meta
list_session_feedbackCRead-onlyIdempotentInspect
List Session Feedback
Inputs: limit, offset, tutor_id, anonymize, +1 more. Returns: data, meta
list_sessionsCRead-onlyIdempotentInspect
List Sessions
Inputs: to, from, limit, offset, +3 more. Returns: data, meta
list_student_groupsCRead-onlyIdempotentInspect
List Student Groups
Inputs: limit, offset, subject_id, classroom_id. Returns: data, meta
list_studentsCRead-onlyIdempotentInspect
List Students
Inputs: limit, offset. Returns: data, meta
list_subjectsARead-onlyIdempotentInspect
List Subjects
Inputs: no named parameters. Returns: `/v1/subjects` returns just `{ "data": [...] }` (no pagination).
list_tutor_reviewsCRead-onlyIdempotentInspect
List Tutor Reviews
Inputs: tutor_id (required), limit, offset, anonymize. Returns: data, meta
list_tutorsCRead-onlyIdempotentInspect
List Tutors
Inputs: limit, offset, is_published. Returns: data, meta
list_tutor_tiersCRead-onlyIdempotentInspect
List Tutor Tiers
Inputs: limit, offset. Returns: data, meta
lookup_userCRead-onlyIdempotentInspect
Lookup User
Inputs: email, phone. Returns: GET /v1/users — a user (staff or org-affiliated student/parent) matched by emai…
org_join_linkDRead-onlyIdempotentInspect
Org Join Link
Inputs: no named parameters. Returns: GET /v1/org/join-link — the org's reusable self-signup join links/codes (share…
parent_balanceCRead-onlyIdempotentInspect
Parent Balance
Inputs: parent_id (required). Returns: parent_id, total_paid_cents, outstanding_cents, open_invoices_count, +1 more
recommend_tutorsCRead-onlyIdempotentInspect
Recommend Tutors
Inputs: request_id (required), limit. Returns: data, request_id, subject_id
reports_summaryDRead-onlyIdempotentInspect
Reports Summary
Inputs: no named parameters. Returns: active_tutors, sessions_today, active_students, outstanding_cents, +2 more
tutor_available_slotsDRead-onlyIdempotentInspect
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_earningsCRead-onlyIdempotentInspect
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
Scored across 59 tools
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.
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.
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.
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
Related MCP Connectors
Read-only MCP for AI usage profiles, leaderboards, stats, and docs; no writes or private data.
Query your org's data in natural language — read-only MCP access to SQL, NoSQL, files & warehouses.
Read-only MCP tools for AI agent discovery, structured resources, and NIULAI information.
The HubSpot MCP Server acts as a bridge that enables AI assistants and Large Language Models to securely interact with HubSpot CRM data through natural conversation, without requiring users to understand complex API structures. It provides read-only access to standard CRM objects (contacts, companies, deals, tickets, products, invoices, and more) and their associations, secured via OAuth 2.0, allowing AI agents to perform tasks like summarizing deals, fetching company updates, and looking up record changes.
Related MCP Servers
- AlicenseAqualityDmaintenanceRead-only MCP server that connects AI clients to Crescender's school asset, loan, member, and asset-comms API.6MIT
- AlicenseNot gradedqualityDmaintenancePublic read-only MCP server for FoxTrove Voice, enabling LLMs to query call logs, customer records, assistant stats, and analytics via secure OAuth.MIT
- AlicenseAqualityDmaintenanceProvides read-only access to LessonLab's lesson workflow, pricing, FAQ, and official links for MCP-compatible AI clients.3MIT
- AlicenseNot gradedqualityCmaintenanceA read-only MCP gateway that enables AI agents to retrieve business data (sales, appointments, clients, inventory, etc.) from the AURON Suite backend with role-based access control, audit logging, and rate limiting.MIT