MCP Server - ClassQuill

What is an MCP Server?

MCP is an open protocol that standardizes how applications provide context to LLMs. Among other benefits, it gives LLMs tools to act on your behalf. The EquateIt MCP server lets MCP-aware tools — Claude Code, Claude Desktop, Cursor, Windsurf and others — read your organisation’s tutoring data through the EquateIt public API. It is read-only and scoped to your org, exactly like the REST API.

Prefer not to install or run anything? Use the hosted server at https://mcp.classquill.com/mcp instead — see AI Connectors to connect Claude (via OAuth), Codex, Composio and others. This page covers running the equateit-mcp package yourself.

Also listed on the Smithery registry:

What it can do

One tool per public endpoint, all read-only:

Sessions — list and fetch tutoring sessions
Tutors — list tutors and pull per-tutor earnings
Payments & invoices — list payments received and invoices issued
Students & parents — list students, parents, and a parent’s balance
Curriculum — subjects, classrooms, student groups, lesson plans, homework, results
Operations — mileage trips, expense claims, and an owner reports summary

As an example, you could ask “How much did each tutor earn last week?” or “List the invoices that are still outstanding.”

Prerequisites

Node.js 18 or later
An EquateIt API key — create one in Settings → Developers (org admins only). See Authentication.

How to use the MCP Server

The server is published to npm and runs with npx — there is nothing to install or host. Replace ei_live_xxxxxxxxx with your own key throughout. It supports two transports: stdio (default, runs locally) and HTTP.

Stdio (default)

Claude Code
Cursor
Claude Desktop
Windsurf

claude mcp add equateit -e EQUATEIT_API_KEY=ei_live_xxxxxxxxx -- npx -y equateit-mcp

Open the command palette → “Cursor Settings” → “MCP” → “Add new global MCP server”.

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

Open Claude Desktop settings → “Developer” → “Edit Config”.

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

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

HTTP transport

Run the server over HTTP for remote or web-based integrations. In HTTP mode each client authenticates by passing its API key as a Bearer token. Start the server:

npx -y equateit-mcp --http --port 3000

It listens on http://127.0.0.1:3000 and exposes the MCP endpoint at /mcp using Streamable HTTP.

Claude Code
Cursor

claude mcp add equateit --transport http http://127.0.0.1:3000/mcp --header "Authorization: Bearer ei_live_xxxxxxxxx"

{
  "mcpServers": {
    "equateit": {
      "url": "http://127.0.0.1:3000/mcp",
      "headers": { "Authorization": "Bearer ei_live_xxxxxxxxx" }
    }
  }
}

Options

Flag	Env var	Default	Purpose
`--key`	`EQUATEIT_API_KEY`	—	Your `ei_live_...` key (stdio mode; HTTP mode reads the Bearer token per request).
`--http`	—	off	Use HTTP transport instead of stdio.
`--port` / `-p`	`MCP_PORT`	`3000`	HTTP port.
—	`EQUATEIT_API_BASE_URL`	production	Backend base URL. Override to target staging.

The MCP server is a thin client over the REST API — all access control, org-scoping and rate limits are enforced by the API itself. A key used here has the same read-only access it does everywhere.

​What is an MCP Server?

​What it can do

​Prerequisites

​How to use the MCP Server

​Stdio (default)

​HTTP transport

​Options

What is an MCP Server?

What it can do

Prerequisites

How to use the MCP Server

Stdio (default)

HTTP transport

Options