# AGENTS.md - BoardGameGeek CLI

You are being asked to install or use the BoardGameGeek CLI from the Printing Press library.

## What it is

boardgamegeek-pp-cli is an agent-native command line tool for BoardGameGeek. Look up board games, expansions, hot rankings, user collections, and logged plays from BoardGameGeek's official XMLAPI2 — search, full game detail with stats and rankings, and the live hot list, all without a browser.
It is a single Go binary that ships with an agent skill, and it installs with one command.

## Install

Recommended (installs the binary and the agent skill):

    npx -y @mvanhorn/printing-press-library install boardgamegeek

Hermes:

    hermes skills install mvanhorn/printing-press-library/cli-skills/pp-boardgamegeek --force

OpenClaw:

    clawhub install printing-press-library/boardgamegeek

## MCP server

This CLI ships an MCP server (boardgamegeek-pp-mcp) with 8 tools. Point any MCP client at it, including Claude Desktop.

## After install

Call boardgamegeek-pp-cli from the shell, or use the /pp-boardgamegeek skill inside an agent.
Run boardgamegeek-pp-cli --help to list commands.

## Links

- Documentation: https://printingpress.dev/documentation/boardgamegeek
- Library page: https://printingpress.dev/library/media-and-entertainment/boardgamegeek
- This file: https://printingpress.dev/documentation/boardgamegeek/agents.md