aoc-mcp

Advent of Code MCP Server

MCP server to interact with the Advent of Code website.

This project is developed for educational purposes. The server aims to simplify interactions with the Advent of Code website and enhance the puzzle-solving workflow.

However, building a self-submitting app around solutions will likely be the most efficient approach.

Tools

GetAocProgress

• Gets star count for a specified Advent of Code year
• Parameters: year (int)
• Returns: Stars (int)

SubmitAnswer

• Submits an answer for an Advent of Code day part. If the previous answer has been given too recently, waits until it can be submitted (with progress notifications).
• Parameters: int year, int day, int part, string answer
• Returns: Correct/Incorrect/TooLow/TooHigh

GetInputResource

• Retrieves the personal puzzle input
• Parameters: int year, int day
• Returns: input text as an embedded resource

SaveInput

• Retrieves a puzzle input and saves to the specified location. Can be useful as many LLMs hallucinate when writing large inputs to a file.
• Parameters: int year, int day, string destinationFullPath
• Returns: nothing

Resources

aocinput://{year}/{day}

Resource template for the personal puzzle input

Use this MCP Server

{
  "mcpServers": {
    "aoc": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "SESSION_COOKIE",
        "ghcr.io/mazharenko/aoc-mcp"
      ],
      "env": {
        "SESSION_COOKIE": "<session>"
      }
    }
  }
}

Prompt examples

> get aoc stats for 2024

> submit "42" for 2024/10/1

> get aoc input for 2024/10 and save it

> Get aoc input for 2024/10 and write it to a new file. Run aoc program for year 2024 day 10, pass 2024 and 10 as positional arguments and the created file path as --input-file argument. Read the answers from the output and submit them.