--- title: README emoji: 🏆 colorFrom: red colorTo: yellow sdk: static pinned: false --- # 🤖 Gradio Agents & MCP Hackathon 2025 🚀 ![Gradio Agents & MCP Hackathon Banner with Sponsors](https://cdn-uploads.huggingface.co/production/uploads/60d2dc1007da9c17c72708f8/4HXPmk3CW5zQmVLBxh2Nx.png) **Update: Signups are open until June 8, and emails with credits are sent periodically to new members joining in.**
Access the [Slides](https://huggingface.co/spaces/Agents-MCP-Hackathon/README/blob/main/Gradio%20x%20Agents%20x%20MCP%20Hackathon.pdf) from our Live Kickoff Youtube stream.
**Note: To have your entry considered for the prizes, you must be a member of this organization and submit your apps here.**
Join our [Discord Community](https://discord.gg/Qe3jMKVczR) channel `agents-mcp-hackathon` for active support during the hackathon.
🚀 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. **Total registrations so far: ~3.5k+** **📅 Date:** June 2 - June 8, 2025 **📍 Location:** Global & Online **🏆 Prizes: $16,500 cash-prizes and more to be won!** **🎁 Bonus: FREE Credits** for participants* from our sponsors worth **$1 MILLION++** - $250 of GPU/CPU Compute credits **TO EVERY PARTICIPANT** in the Hackathon from [Modal Labs](https://modal.com/) - $25 of API credits **TO EVERY PARTICIPANT** in the Hackathon from [Huggingface](https://huggingface.co/) - $25 of API credits to each of the first 3300 participants from [Nebius](https://nebius.com/) - $25 of API credits to each of the first 1000 participants from [Anthropic](https://www.anthropic.com/) - $25 of API credits to each of the first 1000 participants from [OpenAI](https://openai.com/) - $15 of API credits to each of the first 1000 participants from [Hyperbolic Labs](https://hyperbolic.xyz/) - $25 of API credits to each of the first 500 participants from [MistralAI](https://mistral.ai/) - $25 of API credits to each of the first 250 participants from [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 by clicking on the yellow button above (or [clicking here](https://huggingface.co/spaces/ysharma/gradio-hackathon-registration-2025)) 3. **Form a Team (optional)**: 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 (in the form of a [Space](https://huggingface.co/spaces/)) 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 Tool / Server**: Did you know that [any Gradio app can also be an MCP server/tool](https://huggingface.co/blog/gradio-mcp)? Extend the capabilities of your favorite LLM by building a Gradio app to accomplish any specific task and share your Space/MCP tool here. * **🧩 Track 2: Custom Components for Agents**: Do you wish that a particular Gradio component existed? Would it make your life easier or your agent interfaces more intuitive or powerful if one did? This is your chance to put your Python and JavaScript skills to the test and [create your own Gradio custom component](https://www.gradio.app/guides/custom-components-in-five-minutes) for agent applications. * **🤖 Track 3: Agentic Demo Showcase**: In this general category, create any kind of Gradio app that demonstrates the power of AI agents (using MCP tools or not). Show us the most incredible things that your agents can do! See the "Submission Guidelines" section below for more details on each track. ## 🎁 Prizes Total prize pool: **$16,500+ USD in cash, plus many more goodies of credits** ### For each track: - 🥇 First Place: $2,500 USD - 🥈 Second Place: $500 USD ### Special awards: - 👑 [Modal Labs](https://modal.com/) Choice Award: $5000 USD Cash - 🍃 [Mistral AI](https://mistral.ai/) Choice Award: $2000 API Credits - 🦙 [LlamaIndex](https://www.llamaindex.ai/) Choice Award: $1000 USD Cash - 🦙 [Sambanova](https://sambanova.ai/) Choice Award: $500 USD Cash - 🌟 Community Choice Award by [Hugging Face](https://huggingface.co/): $500 USD - 💫 Most Innovative Use of MCP Award by [Hugging Face](https://huggingface.co/): $500 USD - 🤗 [Hugging Face](https://huggingface.co/) Merch to the most engaging participants ## 🗓️ Schedule ### Pre-Hackathon Events - May 20-26: Hackathon announcements ### Hackathon Week - June 3rd: Live-kickoff YouTube event to set the tone and welcome participants (9:00 AM PST / 4:00 PM UTC) - Gradio Office Hours: - MCP Support with [Abubakar](https://huggingface.co/abidlabs): June 4th 11:00 AM PST / 6:00 PM UTC - Custom Components with [Freddy](https://huggingface.co/freddyaboulton) and [Pete](https://huggingface.co/pngwn): June 4th (Time TBD) - Agent Development with [Yuvi](https://huggingface.co/ysharma): June 5th (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 / Tool 1. Your submission should be a Gradio app Space [that is also an MCP Server](https://huggingface.co/blog/gradio-mcp) 2. In your Space `README.md`, add the tag: "mcp-server-track" 3. Please also include in your `README.md` a (link to a) video recording of your MCP server in action using any MCP Client (e.g. Claude Desktop, Cursor, Tiny Agents). If you are using another Gradio app as an MCP Client, that is also an acceptable, you can link to that Space. ### Track 2: Custom Components for Agents 1. Create a [custom Gradio component](https://www.gradio.app/guides/custom-components-in-five-minutes) using Gradio 5 and publish it to Spaces using `gradio cc publish`. 2. In your published Space's `README.md`, add the tag: "custom-component-track" 3. Please also include in your `README.md` a link to a Gradio app or recording of one showing the component in action ### Track 3: Agentic Demo 1. Create a complete Gradio app that showcases any sort of powerful or creative application of AI agents 2. Publish the app on Spaces and in the `README.md`, add the tag: "agent-demo-track" 3. Please also include in your `README.md` a link to a video overview of your app explaining the usage / purpose of the application ## 👥 Connect With Us - Join our [Discord Community](https://discord.gg/Qe3jMKVczR) channel `agents-mcp-hackathon` 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 Agents or MCP to participate?** A: No! We welcome participants of all skill levels. We'll provide resources to help you get started and be available throughout the week on Discord to help answer any questions. **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 likes 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 'n' verified participants will receive API/Compute credits from our sponsors to develop their submissions during the event hackathon.*