# FindClass MCP adapter

The adapter is local stdio only. It forwards the 20 bounded tools to the authenticated backend workflow API.

Trade and fulfillment tools cover permission-filtered order/refund/settlement/slot reads, order rescheduling,
fulfillment recording, and tutor-slot create/close. Payment callbacks are never MCP tools. Refund review remains
in the admin UI because it requires the existing dedicated refund permission and a fresh TOTP; settlement writes
remain in the finance workflow.
Record search and detail lookup cover content, external applications, orders, refunds, settlements, and tutor slots;
every result is filtered by the live permissions of the account that owns the MCP token.
Coupon grants freeze at most 100 selected users and issue one coupon per user; larger or multi-coupon grants stay in the admin UI.

```json
{
  "mcpServers": {
    "findclass": {
      "command": "/absolute/path/to/.venv/bin/python",
      "args": ["/absolute/path/to/findclass-mcp/server.py"],
      "env": {
        "FINDCLASS_BASE_URL": "https://your-findclass-backend",
        "FINDCLASS_MCP_TOKEN": "set-in-the-client-secret-store"
      }
    }
  }
}
```

Install from the hash lock:

```bash
uv venv --python 3.14 .venv
uv pip install --python .venv/bin/python --require-hashes -r requirements.lock
.venv/bin/python -m unittest -v test_server.py
```

Or run `./install-mcp-adapter.sh`; it installs the same hash-locked adapter without writing a token.

The token is reveal-once and must not be written into this repository or ordinary client logs.