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.

{
  "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:

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.