English Français العربية

io.github.EquateItAu/classquill-mcp

السجل الرسمي أخرى

Read-only MCP server for ClassQuill, a tutoring-business-management platform.

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http classquill-mcp 'https://mcp.classquill.com/mcp'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "classquill-mcp": {
            "type": "http",
            "url": "https://mcp.classquill.com/mcp"
        }
    }
}
NPM package equateit-mcp
Claude Code 
claude mcp add classquill-mcp -e 'EQUATEIT_API_KEY=<your equateit_api_key>' -- npx -y equateit-mcp@1.0.1
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "classquill-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "equateit-mcp@1.0.1"
            ],
            "env": {
                "EQUATEIT_API_KEY": "<your equateit_api_key>"
            }
        }
    }
}

متغيرات البيئة

  • EQUATEIT_API_KEY إلزامي سري Your ClassQuill API key (create one in the app under Settings -> Developers). Read-only for this server.

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. ClassQuill MCP server
  2. Two ways to use it
  3. Getting an API key
  4. Tools
  5. Options & environment
  6. Develop
  7. License

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

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

FlagEnv varDefaultPurpose
--keyEQUATEIT_API_KEY—Your ei_live_… key (stdio mode).
--http—offRun as an HTTP (Streamable HTTP) server instead of stdio.
--port / -pMCP_PORT3000HTTP port.
—EQUATEIT_API_BASE_URLhttps://api.classquill.comAPI 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.

الأسئلة الشائعة

ما هو io.github.EquateItAu/classquill-mcp؟

Read-only MCP server for ClassQuill, a tutoring-business-management platform.

كيف أثبّت io.github.EquateItAu/classquill-mcp؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http classquill-mcp 'https://mcp.classquill.com/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.EquateItAu/classquill-mcp إلى مفتاح API؟

نعم. يتطلب EQUATEIT_API_KEY، وتضبطها في إعداداته.

هل io.github.EquateItAu/classquill-mcp مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.EquateItAu/classquill-mcp؟

ينشره EquateItAu. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.