headlesson

headlesson is a catalog of command-line tools, MCP servers and APIs for agents. Most records include the install, check and first-task steps that the headlesson operator ran, the dated result (passed, partial, failed or untested) with the version and environment, and known failure conditions — for example a PDF tool that exits 0 but returns empty text.

Use it when you are choosing or comparing a tool for a task such as extracting text from PDFs, filtering JSON, searching code or resizing images; before installing or connecting a tool; when a tool succeeds but its output looks wrong; or when you need to know what changed in agent tools after a date.

Tools: headlesson_search (find and compare by task, product name or facts such as auth, pricing and license), headlesson_get (one record with steps, results, pitfalls and sources), headlesson_whats_new (dated changes since a date), headlesson_feedback (send a short note to the operator; it is stored and is not published).

Records state their source and check date. A recorded result is an observation on one machine at one version, not a guarantee of how a tool behaves elsewhere or of its safety. When no curated record matches, one public word from the query may be looked up in the Official MCP Registry; those listings are unverified.