# Getting started with Santa 2026

The team dashboard is at [santa2026.lzhang.click](https://santa2026.lzhang.click/). Anyone can read this guide. Use your team GitHub account to open the dashboard or connect an agent.

**Moving from the old server?** The cutoff for `45-77-10-90.sslip.io` is **Friday, 20 November 2026 at 09:00 JST (00:00 UTC)**. Update your bookmark, ChatGPT connection or script before then. Results with an upload receipt are already on the new server.

## Website and GitHub access

1. Sign in to the GitHub account invited to `LZhangGJ/santa-2026`. If it already opens the private repository, continue to the next step. Otherwise accept the invitation from your email or GitHub notifications. If you get a 404, check which account is signed in and ask the team admin to verify the invited username. [GitHub notifications](https://github.com/notifications) · [Team repository](https://github.com/LZhangGJ/santa-2026)
2. Open the dashboard, select GitHub sign-in and bookmark the new address. To submit a result in your browser, open **Upload results**, select your CSV and check the receipt. [Dashboard](https://santa2026.lzhang.click/) · [Upload results](https://santa2026.lzhang.click/progress)

## Connect ChatGPT or another MCP client

1. In ChatGPT on the web, open **Plugins → + → Add custom MCP server**. Enter `Santa 2026` as the name, `https://santa2026.lzhang.click/mcp` as the **Server URL** and **OAuth** as the authentication method. If ChatGPT offers optional client ID and secret fields, leave them empty. Other MCP clients use the same URL and authentication method.
2. In ChatGPT, select **Create as a plugin**, install it and authorize with the GitHub account you use for Santa. In a chat, type `@` and select the new Santa connection. [OpenAI setup instructions](https://developers.openai.com/api/docs/guides/custom-mcp-server)
3. Ask the agent to call `team_status({})`. A successful response shows the number of puzzles in `puzzles` and the verified team total in `steps`. To read the full handbook, call `read_system_guide({"lang":"en"})`. Both calls are read-only. [Member handbook](https://santa2026.lzhang.click/documents/system-guide)

## Upload a CSV from a script

Keep using your valid personal Santa token. If you need one, create it in **Members & settings → Connect an agent or worker**. Set `SANTA_API_TOKEN` on the machine running the script. Existing scripts only need the hostname changed to `santa2026.lzhang.click`. You can test the token with a read-only `GET https://santa2026.lzhang.click/api/team_status` using the same authorization header as below. [Member tokens](https://santa2026.lzhang.click/settings#agent-access)

Use a UTF-8 CSV with the header `id,program`. You can submit one puzzle or all 1,000. From the folder containing `submission.csv`, run the command for your shell.

**macOS or Linux (Bash or zsh)**

To set the token for this terminal, run `read -rs SANTA_API_TOKEN && export SANTA_API_TOKEN`, paste your token and press Enter.

```sh
curl --fail-with-body -H "Authorization: Bearer $SANTA_API_TOKEN" \
  -F "file=@submission.csv" https://santa2026.lzhang.click/api/upload_results
```

**Windows PowerShell**

To set the token for this terminal, run `$env:SANTA_API_TOKEN = [System.Net.NetworkCredential]::new('', (Read-Host 'Santa token' -AsSecureString)).Password` and enter your token when prompted.

```powershell
curl.exe --fail-with-body -H "Authorization: Bearer $env:SANTA_API_TOKEN" -F "file=@submission.csv" https://santa2026.lzhang.click/api/upload_results
```

Open `receipt_url` for the per-puzzle results. `saved_steps` is the improvement over the team's previous best. A successful receipt with `saved_steps: 0` still confirms delivery.

## Update a worker

Set the base URL to `https://santa2026.lzhang.click` in your worker's launch command. Keep your existing worker name, backend and solver. For example, a CPU worker started from the repository directory can use this command.

```sh
python worker.py --name my-cpu --url https://santa2026.lzhang.click -- python solver.py
```

The worker sends heartbeats and reports a finished job with `report_run`. A changed launch command applies the next time the worker starts. If a job still uses the old host and may run past the cutoff, save its CSV or checkpoints outside the worker's temporary directory before the cutoff. You can submit a saved CSV through **Upload results** on the new site.

## Prompt for a new agent

> Read the public setup guide at https://santa2026.lzhang.click/start.md?lang=en first. If the Santa tools are unavailable, ask me to accept the invitation to `LZhangGJ/santa-2026` with my invited GitHub account, add `https://santa2026.lzhang.click/mcp` in the client, select OAuth and authorize it myself. Once connected, call `read_system_guide({"lang":"en"})` and then `team_status({})`. Tell me the team's current verified total in steps.
