Getting started with Santa 2026
The team dashboard is at 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
- 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 · Team repository - 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 · Upload results
Connect ChatGPT or another MCP client
- In ChatGPT on the web, open Plugins → + → Add custom MCP server. Enter
Santa 2026as the name,https://santa2026.lzhang.click/mcpas 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. - 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 - Ask the agent to call
team_status({}). A successful response shows the number of puzzles inpuzzlesand the verified team total insteps. To read the full handbook, callread_system_guide({"lang":"en"}). Both calls are read-only. Member handbook
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
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.
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.
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.
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-2026with my invited GitHub account, addhttps://santa2026.lzhang.click/mcpin the client, select OAuth and authorize it myself. Once connected, callread_system_guide({"lang":"en"})and thenteam_status({}). Tell me the team's current verified total in steps.