Spaces:

freddy-test-org
/

README

Running

File size: 22,933 Bytes

42bdb52
 
dab4cb7
 
 
42bdb52
dab4cb7
08e650b
dab4cb7
 
0a27ef4
dab4cb7
0a27ef4
dab4cb7

---
title: README
emoji: 🏆
colorFrom: yellow
colorTo: red
sdk: static
pinned: true
---
<head>
  <meta property='og:title' content='Title of the article'/>
  <meta property='og:image' content='//huggingface.co/datasets/freddyaboulton/bucket/resolve/main/im-going-to.gif'/>
  <meta property='og:description' content='Description that will show in the preview'/>
  <meta property='og:url' content='//huggingface.co/MCP-1st-Birthday'/>
</head>

# MCP's 1st Birthday - Hosted by Anthropic and Gradio
![MCPs-1st-Birthday-Hackathon_Event-Banner_4k](https://cdn-uploads.huggingface.co/production/uploads/60d2dc1007da9c17c72708f8/s4q7RzD3S-8xQ8ecXrSwb.png)

**With additional support from**: 
<div align="center" style="margin: 10px 0;">
  <div style="display: inline-flex; align-items: center; gap: 30px; justify-content: center; flex-direction: row; flex-wrap: wrap;">
    <img src="https://cdn-uploads.huggingface.co/production/uploads/60d2dc1007da9c17c72708f8/cv0H8kb8LKgJTmTJ8ZIOT.png" alt="Hugging Face" style="height: 45px; max-width: 150px; object-fit: contain;"/>
    <img src="https://cdn-uploads.huggingface.co/production/uploads/60d2dc1007da9c17c72708f8/sT7GzpIaCWyI4XGs1mxVw.png" alt="Google Gemini" style="height: 45px; max-width: 150px; object-fit: contain;"/>
    <picture>
      <source media="(prefers-color-scheme: dark)" srcset="https://cdn-uploads.huggingface.co/production/uploads/60d2dc1007da9c17c72708f8/WwKhDQfnlJieWtt447tyG.png">
      <img src="https://cdn-uploads.huggingface.co/production/uploads/60d2dc1007da9c17c72708f8/OB5cQ9gJL0abDaUIKAaVk.png" alt="Modal" style="height: 45px; max-width: 150px; object-fit: contain;"/>
    </picture>
    <picture>
      <source media="(prefers-color-scheme: dark)" srcset="https://cdn-uploads.huggingface.co/production/uploads/60d2dc1007da9c17c72708f8/pKFNmTSPZCBa7dQB6CX9-.png">
      <img src="https://cdn-uploads.huggingface.co/production/uploads/60d2dc1007da9c17c72708f8/LEenSPauFgK2SH5K806x9.png" alt="SambaNova" style="height: 45px; max-width: 150px; object-fit: contain;"/>
    </picture>
    <picture>
      <source media="(prefers-color-scheme: dark)" srcset="https://cdn-uploads.huggingface.co/production/uploads/60d2dc1007da9c17c72708f8/V4HXogRre80lGXr0W3zvZ.png">
      <img src="https://cdn-uploads.huggingface.co/production/uploads/60d2dc1007da9c17c72708f8/-rwwmnMDZkZEKXmyQkJUT.png" alt="ElevenLabs" style="height: 45px; max-width: 150px; object-fit: contain;"/>
    </picture>
    <picture>
      <source media="(prefers-color-scheme: dark)" srcset="https://huggingface.co/datasets/freddyaboulton/bucket/resolve/main/blaxel_dark.png">
      <img src="https://huggingface.co/datasets/freddyaboulton/bucket/resolve/main/blaxel_light.png" alt="Blaxel-logo" style="height: 45px; max-width: 150px; object-fit: contain;"/>
    </picture>
  </div>
</div>


<!-- Social Sharing Buttons -->
<div align="center" style="margin: 10px 0;">
  <a href="https://www.linkedin.com/sharing/share-offsite/?url=https%3A%2F%2Fhuggingface.co%2FMCP-1st-Birthday" 
     target="_blank"
     style="display: inline-block; 
            background: #0077B5; 
            color: white; 
            padding: 10px 20px; 
            margin: 5px;
            text-decoration: none; 
            border-radius: 8px; 
            font-weight: bold;
            font-size: 16px;">
    Share on LinkedIn
  </a>
  <a href="https://twitter.com/intent/tweet?text=I%27m%20going%20to%20MCP%27s%20first%20birthday%20party%20hosted%20by%20%40AnthropicAI%20and%20%40Gradio%21%20%F0%9F%8E%82%F0%9F%A5%B3%0A%0ASee%20you%20there%20too%21%0Ahttps%3A%2F%2Fhuggingface.co%2FMCP-1st-Birthday" 
     target="_blank"
     style="display: inline-block; 
            background: #000000; 
            color: white; 
            padding: 10px 20px; 
            margin: 5px;
            text-decoration: none; 
            border-radius: 8px; 
            font-weight: bold;
            font-size: 16px;">
    Share on 𝕏
  </a>
  <a href="https://wa.me/?text=I%27m%20going%20to%20MCP%27s%20first%20birthday%20party%20hosted%20by%20%40AnthropicAI%20and%20%40Gradio%21%20%F0%9F%8E%82%F0%9F%A5%B3%0A%0ASee%20you%20there%20too%21%0Ahttps%3A%2F%2Fhuggingface.co%2FMCP-1st-Birthday" 
     target="_blank"
     style="display: inline-block; 
            background: #25D366; 
            color: white; 
            padding: 10px 20px; 
            margin: 5px;
            text-decoration: none; 
            border-radius: 8px; 
            font-weight: bold;
            font-size: 16px;">
    Share on WhatsApp
  </a>
</div>

<div style="display: flex; justify-content: space-between; align-items: flex-start; gap: 40px; margin: 20px 0;">

<!-- Left side: Event Details Table -->
<div style="flex: 1; display: flex; justify-content: center; align-items: flex-start;">
<div>
  
|  |  |
|-------------|-------------|
| 📅 **Duration** | **Nov 14-30, 2025**<br>(17 days, 3 weekends) |
| 💰 **Prize Pool** | **$17,500 USD Cash Prizes**<br>+ Free API Credits |
| 🎯 **Tracks** | **2 Main Tracks**<br>4 Categories |
| 👥 **Team Size** | **Solo or Teams of 2-5** |
| 🌍 **Location** | **Global & Online** |

</div>
</div>

<!-- Right side: Sponsor Credits -->
<div style="flex: 1; padding: 20px; background: rgba(128, 128, 128, 0.1); border: 1px solid rgba(128, 128, 128, 0.3); border-radius: 8px;">

### 🎁 Sponsor Support - **📊 Total Value: $1.58M**

**💵 Cash Prizes: $17,500** (HuggingFace: $15,000 | Modal: $2,500)

**🎟️ API Credits for all participants (We are at ~2,500 participants now):**

- **Anthropic:** $25 × 2,500 = $62,500  
- **Google Gemini:** $15,000  
- **HuggingFace:** $25 × 2,500 = $62,500  
- **ElevenLabs:** $22 × 2 × 2,500 = $110,000  
- **SambaNova:** $25 × 1,500 = $37,500  
- **Blaxel:** $250 × 2,500 = $625,000  
- **Modal:** $250 × 2,500 = $625,000  

</div>
</div>

---

**The MCP revolution continues.** The June 2025 version of Hackathon was a huge success with over 4200 registrations, 1 Millions+ free API credits for participants, and $15000+ awards in cash. Six months later, we are bringing you the next edition of this world event! When we launched this hackathon in June 2025, MCP was experimental. Six months later, OpenAI, Microsoft, and Google have adopted it. The revolution we started is now mainstream—be part of the second wave.

<div style="text-align: center; margin: 30px 0;">
  <a href="https://huggingface.co/spaces/MCP-1st-Birthday/gradio-hackathon-registration-winter25" 
     target="_blank"
     style="display: inline-block; 
            background: #C8DDD7; 
            color: #000000; 
            padding: 20px 40px; 
            text-decoration: none; 
            border-radius: 12px; 
            font-weight: bold; 
            font-size: 24px;
            border: 2px solid #000000;
            box-shadow: 0 4px 12px rgba(0,0,0,0.15);
            transition: all 0.2s;">
    👉 Register for the Hackathon
  </a>
</div>

<style>
a[href*="gradio-hackathon-registration-winter25"]:hover {
    background: #B8CEC7 !important;
    transform: translateY(-2px);
    box-shadow: 0 6px 20px rgba(0,0,0,0.25);
}
</style>

> [!IMPORTANT]
> **To qualify for prizes, you MUST:**
> - ✅ Be a member of this organization (click "Request to join this org" above)
> - ✅ Submit your apps to this organization
> - ✅ Include appropriate track tags in your Space README
> - ✅ Include a link to your social media post about your project
> - ✅ Submit by **November 30, 2025, 11:59 PM UTC**

**Join our [Discord Community](https://discord.gg/fveShqytyh) → Channel: `agents-mcp-hackathon-winter25🏆`** for latest information and active support during the hackathon.

---

## 🚀 Quick Start (3 Easy Steps)

**1️⃣ Join & Register**  
→ [Click "Request to join this org"](#) (top right) + [Complete registration form](https://huggingface.co/spaces/MCP-1st-Birthday/gradio-hackathon-registration-winter25)

**2️⃣ Pick Your Track**  
→ [Track 1: Building MCP] or [Track 2: MCP in Action]

**3️⃣ Start Building (Nov 14)**  
→ [See submission examples](#-submission-guidelines) | [Join HF Discord for help](https://discord.gg/fveShqytyh) | [Access resources](#-resources--getting-started)

---

<div align="center">

## 🌟 Welcome to MCP's 1st Birthday - Hosted by Anthropic and Gradio

</div>

Join us for the definitive AI agents and Model Context Protocol (MCP) development event—now bigger, better, and more accessible than ever. Build cutting-edge agentic applications powered by Gradio 6, leverage vibe coding to accelerate development, and compete for some of the most amazing 🤑cash prizes and credits.

### Why Participate?

<div align="center">

| 🎓 **Learn & Master** | 🏆 **Win Big** | 🤝 **Network** | 🚀 **Build & Ship** |
|----------|--------|------------|----------|
| Latest AI tech stack<br>MCP Protocol<br>Gradio 6 features | $15K+ in cash prizes<br>Free API credits<br>Sponsor rewards | 1000s of developers<br>Industry experts<br>Large AI community | Production-ready apps<br>Portfolio projects<br>Real-world impact |

</div>

### What's New This Year

- **Powered by Gradio 6** with enhanced mobile capabilities and visual editing
- **3 full weekends** to build (Nov 14 - Nov 30)
- **Three new categories:** Productivity, Multimodal, and Games 
- **Vibe coding friendly** — We welcome vibe-coding nd support the movement with our very own [gradio vibe editor](https://www.gradio.app/guides/developing-faster-with-reload-mode#vibe-mode)
- **Social amplification** — share your work, gain visibility
- **FREE API Credits** coming soon from major AI Inference providers

---

<div align="center">

## 💰 Why MCP Matters More Than Ever

</div>

Since our June'25 hackathon, MCP has gone from experimental to mainstream:

- ✨ **OpenAI officially adopted MCP**, later announced Apps SDK built on top of it ([DevDay 2025](https://openai.com/index/introducing-apps-in-chatgpt/))
- 🪟 **Microsoft integrated MCP into Windows 11** ([Build 2025](https://blogs.windows.com/windowsexperience/2025/05/19/securing-the-model-context-protocol-building-a-safer-agentic-future-on-windows/))
- 🧠 **Google DeepMind joined the ecosystem** ([Demis Hassabis's tweet](https://x.com/demishassabis/status/1910107859041271977))

**MCP is no longer experimental—it's the foundation of modern agentic AI.** This is your opportunity to build on the protocol that's reshaping how AI systems connect to the world.

---

<div align="center">

## 🛠️ Hackathon Tracks

</div>

<table>
<tr>
<td width="50%" valign="top">

### 🔧 Track 1: Building MCP

Build MCP servers that extend LLM capabilities. It can be a gradio app or not. 
Read: [Any Gradio app can be an MCP server](https://huggingface.co/blog/gradio-mcp)—create tools for data analysis, API integrations, specialized workflows, or novel capabilities that make AI agents more powerful.

**What to Build:**
- MCP servers
- Tool integrations
- Protocol extensions
- Multi-tool systems

**Three Categories:**
1. **Enterprise MCP Servers** - Tag: `"building-mcp-track-enterprise"`
2. **Consumer MCP Servers** - Tag: `"building-mcp-track-consumer"`
3. **Creative MCP Servers** - Tags: `"building-mcp-track-creative"`

**Track Tag:** `"building-mcp-track-"`

**Examples of tagging your app to participate under a specific track:**
- [See example](https://huggingface.co/spaces/ysharma/sample6-hackathon-space-submission/blob/main/README.md)

**💰 Prize Pool:**
- 🥇 **First Place:** $1,500 USD
- 🥈 **Second Place:** $500 USD

</td>
<td width="50%" valign="top">

### 🤖 Track 2: MCP in Action

Create complete AI agent gradio applications that showcase autonomous reasoning, planning, and execution. Use MCP tools, vibe coding, or traditional development—whatever brings your agent vision to life.

**Three Categories:**
1. **Enterprise Applications** - Tag: `"mcp-in-action-track-enterprise"`
2. **Customer Applications** - Tag: `"mcp-in-action-track-consumer"`
3. **Creative Applications** - Tags: `"mcp-in-action-track-creative"` 

**Track Tag:** `"mcp-in-action-track-"`

**Examples of tagging your app to participate under a specific track:**
- [Enterprise](https://huggingface.co/spaces/ysharma/sample2-hackathon-space-submission/blob/main/README.md) | [Customer](https://huggingface.co/spaces/ysharma/sample3-hackathon-space-submission/blob/main/README.md) | [Creative](https://huggingface.co/spaces/ysharma/sample5-hackathon-space-submission/blob/main/README.md)

**💰 Prize Pool (Per Category):**
- 🥇 **First Place:** $2,500 USD
- 🥈 **Second Place:** $1,000 USD
- 🥉 **Third Place:** $500 USD

</td>
</tr>
</table>

> [!TIP]
> **You can submit the same app to multiple tracks!** ([See example](https://huggingface.co/spaces/ysharma/sample1-hackathon-space-submission/blob/main/README.md))  
> **You can submit multiple entries!** Build as many projects as you want.

---

<div align="center">

## 🎁 Prize Structure

**Total Prize Pool: $15,000+ USD + API Credits + Sponsor Bonuses**

</div>

### 🏆 Main Track Prizes

**Building MCP:**
- 🥇 First Place: **$1,500 USD**
- 🥈 Second Place: **$500 USD**

**MCP in Action** (3 prizes per category × 3 categories):
- 🥇 First Place: **$2,500 USD** (×3 categories)
- 🥈 Second Place: **$1,000 USD** (×3 categories)
- 🥉 Third Place: **$500 USD** (×3 categories)

### ⭐ Special Awards

- 🌟 **Community Choice Award:** $1,000 USD (most social engagement)
- 🏢 **Sponsor Choice Awards:** (announced with sponsors)
  -  Modal Innovation Award: Build with Modal and stand to win **$2,500 cash award** for the best project!
  -  Google Gemini special category award: Build with Gemini API and stand to win $15,000 worth of Gemini API  credits from Google!
- 🤗 **Hugging Face Merch:** For most engaging participants and community builders

---

<div align="center">

## 💸 Sponsors & Credits

</div>

**API & Compute Credits** (Details announced soon):
- We are securing API credits for participants from major AI providers
- Access to latest and strongest LLMs from major providers

Announcements rolling out weekly. Follow [@Gradio](https://x.com/Gradio) for the latest updates.

---

<div align="center">

## 🗓️ Timeline

</div>

### 📅 Pre-Hackathon Phase
**October 13 - November 13**
- Sponsor announcements rolling out
- Educational content releases
- Registration opens
- Community building

### 🔨 Hackathon Period
- **November 14 (Friday, 12:00 AM UTC)** - 🚀 Hackathon opens!
- **November 14/15** - 📺 Kickoff stream on YouTube (time TBA)
- **November 17-28** - 💬 Office hours with Gradio team and sponsors
- **November 30 (Saturday, 11:59 PM UTC)** - ⏰ Final submissions due

### 🏅 Post-Hackathon Phase
- **December 1-14** - 👨‍⚖️ Judging period
- **December 15** - 🎉 Winners announcement and showcase

---

<div align="center">

## 📝 Submission Guidelines

</div>

### All Tracks - General Requirements

1. **Publish your project** as a Hugging Face Space in this organization
2. **Add the appropriate track tag** to your Space `README.md`:
   - `"building-mcp-track-xx"` for Track 1
   - `"mcp-in-action-track-xx"` for Track 2
3. **Include a link to your social media post** (X, LinkedIn, etc.) about your project
4. **Include a demo video** (1-5 minutes) showing your project in action. For example, look at some of the submissions from the Hackathon in June: 
   - [Example 1](https://huggingface.co/spaces/Agents-MCP-Hackathon/Sentinel_One/blob/main/README.md#welcome-to-our-submission-for-the-hugging-face-genai-agents--mcp-hackathonthis-project-showcases-a-multi-agent-system-powered-by-gradio-and-smolagents-designed-to-monitor-process-and-analyze-environmental-data-to-assess-climate-related-risks-and-provide-recommendations-link-to-demo--httpsyoutubealk_husrl4w)
   - [Example 2](https://huggingface.co/spaces/Agents-MCP-Hackathon/cs-agent/blob/main/README.md#%F0%9F%93%B9-preview)
   - [Example 3](https://huggingface.co/spaces/Agents-MCP-Hackathon/geocalc-mcp/blob/main/README.md#%F0%9F%8E%A5-demo-video)
5. **Original work only** - All work must be created during the hackathon period (Nov 14-30)

### Track-Specific Requirements

**🔧 Track 1: Building MCP**
- Must be a functioning MCP server
- Can be a gradio app
- Include video showing integration with an MCP client (Claude Desktop, Cursor, etc.)
- Document the tool's purpose, capabilities, and usage

**🤖 Track 2: MCP in Action**
- Must demonstrate autonomous Agents behavior (planning, reasoning, execution)
- Must use MCP servers as tools
- Must be a gradio app
- **Bonus points** for showcasing advanced Agent features like Context Engineering, RAG, etc 
  - Learn more: [Anthropic](https://www.anthropic.com/engineering/effective-context-engineering-for-ai-agents) | [LangChain](https://blog.langchain.com/context-engineering-for-agents/) | [dbreunig](https://www.dbreunig.com/2025/07/24/why-the-term-context-engineering-matters.html)
- Show clear user value and practical application

---

<div align="center">

## 🏅 Judging Criteria

</div>

Projects will be evaluated on:
- **Submissions should be complete** - HF Space + Social media post + Documentation in the Space readme + Demo Video recording of your Space
- **Design/Polished UI-UX** - How polished, intuitive, and easy-to-use the app is?
- **Functionality** - To what extent did the app uses the relevant Gradio functionalities (Gradio 6, MCPs, Agentic Chatbots etc)?
- **Creativity** - How innovative or original is the project idea and implementation?
- **Documentation** - How well communicated is the implementation in the README and/or demo video?
- **Real-world impact** - How much potential does the project have for real-world usefulness or application?

**Community Choice Award** based on:
- Social media engagement (likes, shares, comments)
- Space interactions (_Discussions_ tab) on Hugging Face
- Discord community engagement

---

## 💻 Resources & Getting Started

<details>
<summary><b>📚 Click to see Technical Documentation</b></summary>

### Official Documentation
- [Getting Started with MCP in Gradio](https://huggingface.co/blog/gradio-mcp)
- [Gradio 6 Documentation](https://www.gradio.app/)
- [Building Mobile-First AI Apps](https://github.com/gradio-app/gradio-mobile-app)
- [Custom Components Guide](https://www.gradio.app/guides/custom-components-in-five-minutes)
- [Vibe Coding with Gradio](https://www.youtube.com/watch?v=dis1BwDzmYs)
- [Agent Development Patterns](https://www.gradio.app/guides/agents-and-tool-usage)

### Educational Content
- **Video Tutorials:** Coming soon
- **Blog Posts / Guides:** Case Studies from June Hackathon
- **Office Hours:** Live sessions with experts (schedule announced soon)

</details>

---

## ❓ Frequently Asked Questions

<details>
<summary><b>❓ I'm new to MCP. Can I still participate?</b></summary>

Absolutely! We provide comprehensive tutorials on MCP and will have office hours throughout to support participants.
</details>

<details>
<summary><b>🛠️ Can I use vibe coding tools like Bolt, Lovable, or Cursor?</b></summary>

Yes! Use any tools that help you build. We celebrate results, not just process.
</details>

<details>
<summary><b>🔨 Do I need to build everything from scratch?</b></summary>

No. You can use existing libraries, frameworks, and tools. Just ensure your core contribution is original and created during the hackathon.
</details>

<details>
<summary><b>👥 Can I participate solo or do I need a team?</b></summary>

Both! Participate individually or in teams of 2-5 members.
</details>

<details>
<summary><b>🔄 What if I participated in the June hackathon?</b></summary>

Welcome back! Build something new or significantly evolve your previous project. Previous winners are eligible.
</details>

<details>
<summary><b>💻 Is there a specific programming language requirement?</b></summary>

Gradio is Python-based, but you can integrate other languages/services as needed.
</details>

<details>
<summary><b>❓ How do I get help during the hackathon?</b></summary>

Discord support, office hours, documentation, and community help available throughout.
</details>

<details>
<summary><b>🎯 Can I submit to multiple tracks?</b></summary>

Yes! Submit the same project to multiple tracks or create multiple separate projects.
</details>

<details>
<summary><b>📱 What counts as "mobile-first"?</b></summary>

Responsive design, touch optimization, mobile-appropriate interactions. Doesn't need to be a native app—PWAs and responsive web apps qualify.
</details>

---

## 👥 Connect & Community

- **💬 Discord:** [Join #agents-mcp-hackathon-winter25🏆](https://discord.gg/fveShqytyh)
- **🐦 Twitter/X:** [@Gradio](https://x.com/gradio)
- **💼 LinkedIn:** [Gradio](https://www.linkedin.com/company/gradio/)

---

## ⚖️ Policies & Rules

<details>
<summary><b>📋 Click to see Policies & Guidelines</b></summary>

By participating, you agree to:
- [Code of Conduct](https://huggingface.co/code-of-conduct)
- [Submission Guidelines](#submission-guidelines)
- [Intellectual Property Policy](https://huggingface.co/content-policy)

### Important Rules:
- ✅ All submissions must be original work
- ✅ Projects must be created between November 14-30, 2025
- ✅ Open source licenses encouraged (MIT, Apache 2.0, etc.)
- ✅ Participants retain IP rights to their work
- ✅ By submitting, you grant Hugging Face/Gradio right to showcase your work

</details>

---

<div align="center">

## 🚀 From June to November: The Evolution

**June 2025:** 4,200+ registrations | ~650 submissions | $1M+ in API/GPU Credits

**November 2025:** Targeting trippling the registrations | 3x the prizes | Establishing Gradio agents-mcp hackathon as the industry-standard definitive event

Join the community that launched the MCP developer movement. Build the future of agentic AI.

---

**📅 Registration open**  
**🔨 Building starts: November 14, 2025**  
**⏰ Submissions close: November 30, 2025**

---

<div style="text-align: center; margin: 30px 0;">
  <a href="https://huggingface.co/spaces/MCP-1st-Birthday/gradio-hackathon-registration-winter25" 
     target="_blank"
     style="display: inline-block; 
            background: #C8DDD7; 
            color: #000000; 
            padding: 20px 40px; 
            text-decoration: none; 
            border-radius: 12px; 
            font-weight: bold; 
            font-size: 24px;
            border: 2px solid #000000;
            box-shadow: 0 4px 12px rgba(0,0,0,0.15);
            transition: all 0.2s;">
    🎯 REGISTER NOW & START BUILDING
  </a>
</div>

<style>
a[href*="gradio-hackathon-registration-winter25"]:hover {
    background: #B8CEC7 !important;
    transform: translateY(-2px);
    box-shadow: 0 6px 20px rgba(0,0,0,0.25);
}
</style>

*Questions? Reach out in [Discord](https://discord.gg/fveShqytyh) or email: [email protected]*

</div>