--- title: README emoji: 🏆 colorFrom: red colorTo: yellow sdk: static pinned: false --- # 🤖 Gradio Agents & MCP Hackathon 2025 🚀 ![Gradio Agents & MCP Hackathon Banner](https://cdn-uploads.huggingface.co/production/uploads/60d2dc1007da9c17c72708f8/xAc4MC6yflxPM-cD-HaIZ.png)
🚀 Register for the Hackathon
## 🌟 Welcome to the incredible Agents & MCP Hackathon! Join us for an exciting week-long adventure into the world of Model Context Protocol (MCP) and AI Agents! Let's push together the boundaries of what's possible with MCP and AI Agentic systems. **📅 Date:** June 2 - June 8, 2025 **📍 Location:** Global & Online **🏆 Prizes: $10,000 cash-prizes and more to be won!** **🎁 Bonus:** Free API credits for participants* from our sponsor [Sambanova.AI](https://sambanova.ai/) ## 📝 How to Participate 1. **Join our Organization**: Click the "Request to join this org" button at the top right corner of this page 2. **Register**: Fill out the registration form linked above 3. **Form a Team**: You can participate as an individual or as a team of 2-5 members 4. **Build Your Project**: Follow the specific guidelines for your chosen track ⬇️ 5. **Submit**: Push your project to this organization before the deadline (June 8, 2025, 11:59 PM UTC) ## 💡 What is MCP? Model Context Protocol (MCP) is an open protocol that standardizes how applications provide context to LLMs. MCP enables models to interact with the world. Learn more at [modelcontextprotocol.io](https://modelcontextprotocol.io/introduction). ## 🛠️ Hackathon Tracks ### 🔧 Track 1: MCP Server Implementation Build, extend, or innovate on MCP servers with Gradio. Create powerful tools that leverage the full potential of the Model Context Protocol. ### 🧩 Track 2: Custom Agent Components Design and develop custom Gradio components specifically optimized for agent interactions. Make agent interfaces more intuitive, responsive, and powerful. ### 🤖 Track 3: Agentic Demo Showcase Create a complete end-to-end gradio application that demonstrates the power of AI agents (using MCP or not). Show us what agents can do! ## 🎁 Prizes Total prize pool: **$10,000 USD in cash, plus more goodies** ### For each track: - 🥇 First Place: $2,500 USD - 🥈 Second Place: $500 USD ### Special awards: - 🌟 Community Choice: $500 USD - 💫 Most Innovative Use of MCP: $500 USD - 🤗 HF Merch to the most engaging participants ## 🗓️ Schedule ### Pre-Hackathon Events - May 20-26: Hackathon announcements - May 20-26: Gradio Agent Course release ### Hackathon Week - June-2/3: Live-kickoff YouTube event to set the tone and welcome the participants (9:00 AM UTC) - Gradio Office Hours: - MCP Support with [Abubakar](https://huggingface.co/abidlabs): June-3 10:00 AM UTC (Time TBD) - Custom Components with [Freddy](https://huggingface.co/freddyaboulton) and [Pete](https://huggingface.co/pngwn): June-4 10:00 PM UTC (Time TBD) - Agent Development with [Yuvi](https://huggingface.co/ysharma): June-5 10:00 PM UTC (Time TBD) - June 8: Final Submissions Due (11:59 PM UTC) ### Post-Hackathon - June 9-12: Judging Period - June 13: Winners Announcement ## 💻 Resources ### Technical Documentation - [Getting Started with MCP with Gradio](https://huggingface.co/blog/gradio-mcp) - [Gradio Component Development Guide](https://www.gradio.app/guides/custom-components-in-five-minutes) - [Agent Development Resources](https://www.gradio.app/guides/agents-and-tool-usage) ### Starter Templates (*This section is WIP*) - [MCP Server Boilerplate](https://dummy-link-for-mcp-server-starter) - [Custom Component Template](https://dummy-link-for-gradio-component-template) - [Basic Agent Demo](https://dummy-link-for-basic-agent-demo) ## 🎯 Submission Guidelines ### Track 1: MCP Server Implementation 1. Your submission must implement MCP Server (and or Client) functionalities uisng Gradio 2. Create another Gradio Space that showcases your MCP Server in action 3. If your implementations involve IDEs (or Claude Desktop), please include a video recording. If you are using another Gradio app as a Host, that is also an acceptable entry. 4. Include your Gradio Space README.md with: - Overview of your implementation - Setup instructions - Examples of usage 5. Tag your Spaces readme with "mcp-server-track" ### Track 2: Custom Agent Components 1. Custom Component must be compatible with Gradio's latest version 2. Include a Gradio demo on Spaces showing the component in action 3. Provide documentation on component usage through Spaces README.md 4. Tag your Spaces readme with "custom-component-track" ### Track 3: Agentic Demo 1. Create a complete Gradio app that showcases AI agents 2. Host the app on Spaces 3. Tag your Spaces readme with "agent-demo-track" ## 👥 Connect With Us - Join our [Discord Community](https://discord.com/channels/879548962464493619/1376476916055281776) for active support during the hackathon. - Follow us on [Twitter](https://x.com/Gradio), [LinkedIn](https://www.linkedin.com/company/gradio/) to follow latest announcements for the event. - Subscribe to our [YouTube Channel](https://www.youtube.com/@OfficialGradio) ## ⚖️ Hackathon Policies By participating in this hackathon, you agree to: - Our [Code of Conduct](https://huggingface.co/code-of-conduct) - The [Submission Guidelines](https://huggingface.co/Agents-MCP-Hackathon#:~:text=%F0%9F%8E%AF%20Submission%20Guidelines) - Our [Intellectual Property Policy](https://huggingface.co/content-policy#:~:text=4.%20Privacy%20and%20Intellectual%20Property%20(IP)) All submissions must be original work created during the hackathon period. ## ❓ FAQ **Q: Do I need to have experience with MCP to participate?** A: No! We welcome participants of all skill levels. We'll provide resources to help you get started. **Q: Can I participate as an individual?** A: Yes! You can participate as an individual or in a team of up to 5 members. **Q: How will projects be judged?** A: Projects will be evaluated based on innovation, technical implementation, usability, and impact. Community like on Spaces will also be considered. **Q: Will there be support available during the hackathon?** A: Yes! We'll have regular office hours with experts, a dedicated Discord channel, and comprehensive documentation. --- **First 250 verified participants will receive complimentary API credits to develop their submissions during the event hackathon.*