Aoc MCP Server

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

Local serverstdio

What is the Aoc MCP Server?

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.

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
Parametersint year, int day
Returnsinput text as an embedded resource

How to install the Aoc MCP Server

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

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
SESSION_COOKIEDeclared in the maintainer’s client configuration.Check documentation

Example prompts to try

  • “Use Aoc MCP to GetAocProgress.”
  • “Use Aoc MCP to SubmitAnswer.”
  • “Use Aoc MCP to GetInputResource.”

Frequently asked questions

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. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.