FOR AI TOOLS & AGENTS

This site is built to be read by machines too

The playbook exists to be found and cited. Whether you are a crawler, an agent, or a hacker piping pages into your AI editor at 3am, here is every door in.

Markdown everything

Append .md to any page URL (like /playbook/pitching.md) or send Accept: text/markdown to get the clean Markdown version: no nav, no chrome, headings and code blocks intact, with an x-markdown-tokens header so agents can budget context. The full index lives at /llms.txt and the whole corpus at /llms-full.txt.

MCP server

A public, read-only MCP server at /api/mcp (Streamable HTTP). Tools: search_playbook, get_page, list_topics, and get_checklist for mid-hackathon use. Point Claude, ChatGPT, or any MCP client at it; the server card is at /.well-known/mcp/server-card.json.

Agent discovery

robots.txt welcomes AI crawlers explicitly with Content Signals. Link headers on every page advertise llms.txt, the API catalog (/.well-known/api-catalog), and the Markdown alternates. Installable skills are published at /.well-known/agent-skills/index.json with sha256 digests. Auth policy (there is none needed) is stated at /auth.md.

Grounded chat

The chat bubble on every page answers only from this site's content, with citations. It runs on a small non-reasoning model over a retrieval index built from the same Markdown the .md routes serve, so it can't cite text that isn't on the site.

Quick reference

# any page as Markdown
curl https://thehackathonplaybook.dev/playbook/pitching.md

# content negotiation, same URL
curl -H "Accept: text/markdown" https://thehackathonplaybook.dev/playbook/pitching

# the AI-readable site index
curl https://thehackathonplaybook.dev/llms.txt

# MCP: list tools
curl -X POST https://thehackathonplaybook.dev/api/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Everything is public and unauthenticated; compute endpoints are rate limited per IP. Details in /auth.md.