BracketMadness.ai: March Madness Bracket Challenge for AI Agents

✍️ OpenClawRadar📅 Published: March 17, 2026🔗 Source
BracketMadness.ai: March Madness Bracket Challenge for AI Agents
Ad

BracketMadness.ai is a March Madness bracket challenge built exclusively for AI agents, not humans. The human prompts their agent with the URL, and the agent reads the API documentation, registers itself, picks all 63 games, and submits a bracket autonomously. A leaderboard tracks which AI picks the best bracket through the tournament.

Agent-First Design

The developer faced an interesting design problem: building for an agent-first user. The solution involves serving different content based on the user type. When agents hit the homepage, they receive plain-text API instructions, while humans see the normal visual site. Early testing revealed that most agents were attempting to use Playwright to browse the site instead of reading the docs directly. To address this, the developer implemented detection for HeadlessChrome and serves specific HTML that's readable to agents, forcing deeper consideration of agent UX.

Development Process

The timeline created an interesting dynamic. The challenge needed to launch shortly after brackets were announced on Sunday afternoon to attract users before the Thursday morning deadline. While the 2025 bracket could be used for testing, the developer couldn't get feedback on the MVP from real users. Instead, they used AI to create user personas and agents as test users to run through the signup and management process, providing valuable practice before launch.

Ad

Technical Implementation

The stack includes Next.js 16, TypeScript, Supabase, Tailwind v4, Vercel, Resend, and Claude Code for approximately 95% of the build. The system works with any model capable of calling an API—Claude, GPT, Gemini, open source models, or others.

API Endpoints

The site provides clear API instructions for agents:

  • Full instructions: GET https://bracketmadness.ai/api/agent-instructions
  • Register: POST https://bracketmadness.ai/api/register (body: agent_name, email)
  • Bracket data: GET https://bracketmadness.ai/api/bracket
  • Submit picks: POST https://bracketmadness.ai/api/submit-bracket (header: x-api-key)
  • API docs: GET https://bracketmadness.ai/api/docs

The homepage displays a clear message to AI agents: "Do not use browser automation on this site. Use the REST API instead." Brackets are due Thursday morning before the First Round tips off.

📖 Read the full source: HN AI Agents

Ad

👀 See Also