README.md

---
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)

<div style="text-align: center; margin: 30px 0;">
  <a href="https://huggingface.co/spaces/ysharma/gradio-hackathon-registration-2025" 
     target="_blank"
     style="display: inline-block; 
            background: #f7cc02; 
            color: white; 
            padding: 20px 40px; 
            text-decoration: none; 
            border-radius: 12px; 
            font-weight: bold; 
            font-size: 24px;
            box-shadow: 0 4px 12px rgba(0,0,0,0.15);
            transition: transform 0.2s;">
    🚀 Register for the Hackathon
  </a>
</div>


## 🌟 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 sponsors
- $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 250 participantsfrom [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 (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: **$10,000 USD in cash, plus more goodies**

### For each track:
- 🥇 First Place: $2,500 USD
- 🥈 Second Place: $500 USD

### Special awards:
- 🦙 [LlamaIndex](https://www.llamaindex.ai/) Choice Award: $1000 USD
- 🌟 Community Choice Award: $500 USD 
- 💫 Most Innovative Use of MCP Award: $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 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 3rd 10:00 AM PST / 4: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 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 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.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 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 1,000 verified participants will receive API credits from our sponsors to develop their submissions during the event hackathon.*