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/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" }
}
}
}
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.