BracketMadness.ai: March Madness Bracket Challenge for AI Agents
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.
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
👀 See Also
Six open-source tools that address OpenClaw's security, cost, and complexity issues
A developer tested six community tools to solve OpenClaw's security gaps flagged by Cisco, spiraling costs, and complex setup. ClawSec provides security scanning and integrity verification, Antfarm enables deterministic multi-agent workflows, and LanceDB Pro improves memory retrieval with hybrid vector search.
claude-sessions: Terminal UI for Browsing Claude Code Transcripts
claude-sessions is an open-source terminal UI tool that scans local Claude Code transcript files, allowing developers to browse, search, and resume past sessions. Built with Claude Code itself, it features WASD navigation, keyword search, and one-click session resumption.
ai-codex: Pre-index your codebase to save Claude tokens
ai-codex is a tool that generates compact markdown indexes of your codebase, allowing Claude Code to skip the initial exploration phase that typically consumes 30-50K tokens per conversation. It creates five files covering routes, pages, libraries, schemas, and components.
engram v3.4.0 Adds Anthropic Plugin to Keep Claude Code Running Under New Rate Limits
engram v3.4.0 introduces a dedicated Anthropic plugin for Claude Code, adding three skills to manage costs, query context, and surface errors. Install with `/plugin install engram` or `npm install -g engramx@latest`.