adam-mcp login   # Sign in through Chrome; credentials stay in the browser
adam-mcp status  # Verify the local session
adam-mcp        # Start the stdio server through your MCP client

For guided setup: adam-mcp setup --client codex --write --login. Choose codex, cursor, claude-desktop, windsurf, or vscode. Setup previews by default; --write backs up and merges existing configuration, and --login verifies the course listing. adam-mcp doctor --client codex checks prerequisites and passive session state without launching Chrome. Restart your client and enable adam.

Run adam-mcp logout to stop the local session. --browser is optional.

Version 0.3.0 also supports adam-mcp download FILE_ID --output-dir DIRECTORY --confirm. Choose one file from adam_list_files and an existing directory outside Git. This CLI-only command streams up to 256 MiB in 120 seconds, preserves existing files and returns a local path, source URL, size and digest. It adds no MCP tool and sends no file bytes to the model. Destination filesystems must support hard links; HTML-shaped and empty responses are refused. See download details.

Page text, file text, exercise instructions, and forum posts require approval for the selected object. Clients with elicitation support can request approval; other clients use confirm: true. Summaries and metadata remain read-only. Exams, grades, submissions, and other writes are unsupported. Scanned PDFs require opening the file in ADAM; OCR is not provided.

For client configuration and the currently verified clone/setup path, see the project README and setup guide. This unofficial community server is read-only. Tool output follows your client's model provider; it never returns file bytes. See the limitations and privacy notes.

Client configuration support and walkthrough evidence are recorded in the compatibility matrix. Maintainers: see the release guide.

License: GPL-3.0-or-later.

Each distributed package includes SOURCE.md with its exact source commit, immutable source archive URL, and build directions. The source archive includes the project source, lockfile, build scripts, tests and license notices.