essencestudy-teacher-mcp

# EssenceStudy Teacher MCP Run an EssenceStudy course from your terminal — create assignments, attach documents, write rubrics, enrol students, read and grade submissions, publish grades, and watch token spend — through any MCP client (Claude Code, Claude Desktop, or your own agent). ## Install Published on PyPI — nothing to clone. With `uv` installed, `uvx` runs it directly: ```bash # Claude Code: claude mcp add essencestudy-teacher -- uvx essencestudy-teacher-mcp ``` ## Configure Claude Desktop / any MCP client (no credentials in config files): ```json { "mcpServers": { "essencestudy-teacher": { "command": "uvx", "args": ["essencestudy-teacher-mcp"] } } } ``` You need a **teacher account** on EssenceStudy — students cannot approve a terminal key. The first time you use it, run **`authorize_terminal`**. It returns a link and a short code straight away: > **Open this link:** https://study.essencescholar.com/?device=XXXX-XXXX > **Code:** `XXXX-XXXX` Open the link in the browser where you are already signed in to EssenceStudy, check the code matches, and press Approve. Then call **`finish_authorization`** to collect the key — it is written to `~/.essencestudy/credentials` (mode 600) and reused from then on. Two steps rather than one on purpose: a single blocking call cannot show you the code, because an MCP server's stdout is the protocol channel to the client, not your screen. Revoke it whenever you like — from your profile in the web app, or with `revoke_terminal_access`. A revoked key stops working immediately. **Optional environment** - `ESSENCESTUDY_API_URL` — defaults to production. Point at `http://127.0.0.1:8004` for nightly; keys are stored per backend URL, so both can be authorised at once. Note nightly shares the production database, so writes there are real. - `ESSENCESTUDY_API_KEY` — supply a key directly and skip the browser step. For CI, where nobody can click Approve. ## What you can say - *"List my cou…