Summary
The puzzle loop without the browser tab.
Fetch the input, run your solution, submit the answer — the three steps that normally mean switching to a browser happen where the code is.
What it is
A server for the Advent of Code website. It fetches your personal puzzle input, submits answers, and reports your star count for a year. When an answer arrives too soon after the last one, it waits out the cooldown and reports progress rather than failing.
What you get
- GetInputResource returns your personal puzzle input for a year and day as an embedded resource
- SubmitAnswer submits an answer for a day and part and comes back Correct, Incorrect, TooLow or TooHigh
- GetAocProgress returns your star count for a year
- The submission rate limit is handled for you: too soon means it waits, with progress notifications, instead of erroring
- An aocinput://{year}/{day} resource template exposes the same input to clients that read resources
Requirements
Docker, and your Advent of Code session cookie passed as SESSION_COOKIE. The published image is ghcr.io/mazharenko/aoc-mcp.
Setup effort
One command plus a key — docker run -i --rm -e SESSION_COOKIE ghcr.io/mazharenko/aoc-mcp, then supply credentials