i have learned that if the request accepts html, just give them that, however, some agents will ask for text/markdown, so just give them that.

you can even take OPs ideas further: text/html? serve html help page; text/markdown? serve the same but pure text, maybe nudge the agent on how to install the mcp; application/json? pass through to the mcp app.

the whole llms.txt thing could have been that