Santa 2026

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

  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 · Team repository
  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 · Upload results

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
  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

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-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.