essenceteacher-mcp

# EssenceTeacher MCP An MCP server that puts a teacher's own courses, assignments, submissions and student-support queue in front of an AI assistant — so "where is my class stuck?" is answered from the real data instead of from a description of it. Companion to [`essencescholar-mcp`](https://pypi.org/project/essencescholar-mcp/), which does the same for the research platform. ## Install Nothing to install — run it with `uvx`: ```json { "mcpServers": { "essenceteacher": { "command": "uvx", "args": ["essenceteacher-mcp"] } } } ``` That's the whole config. There is deliberately **no API key in it**: the first time a tool needs one, ask your assistant to sign in. ## Signing in Say *"sign in to EssenceTeacher"*. The `sign_in` tool prints a short code and a URL; open it in a browser where you are already signed in, approve the code, and the key is collected once and stored at `~/.config/essenceteacher/api_key` (owner-read only). Later sessions just work. No key is ever pasted into a chat. Only teaching staff can approve — a student account is refused by the server. If you would rather manage the credential yourself, set `ESSENCETEACHER_API_KEY` and `sign_in` is never needed. `ESSENCETEACHER_API_URL` points at a different deployment; it defaults to `https://api.essencescholar.com` (the API host — `study.essencescholar.com` is the web app and will not answer). ## Tools **Getting in** — `sign_in`, `whoami` **Courses** — `list_courses`, `course_details`, `list_materials`, `gradebook` **Assignments** — `list_assignments`, `get_assignment`, `assignment_usage`, `list_submissions` **Student support** — `flagged_questions`, `announcements` **Long jobs** — `list_jobs`, `get_job` Start at `list_courses`; its ids feed everything else. ## It reads; it does not act Every tool here is read-only. There is nothing that publishes grades, edits a rubric, posts an announcement or reruns a student's submission — and that is a design decision, not an…