---
title: README
emoji: 🦀
colorFrom: pink
colorTo: yellow
sdk: static
pinned: false
---

# Welcome to the 🤗 Model Context Protocol (MCP) Course Organization!

The **Model Context Protocol (MCP) Course** is your comprehensive guide to understanding, using, and building cutting-edge AI applications that leverage external data and tools through the latest MCP standards. This free course is designed to take you from beginner to an informed practitioner in the world of MCP.


## 📑 Course Resources

<div style="width: 100%; border: 1px solid #ccc; padding: 20px; margin: 20px auto; box-shadow: 2px 2px 5px rgba(0, 0, 0, 0.1); margin: 20px auto; box-shadow: 2px 2px 5px rgba(0, 0, 0, 0.1); border-radius: 8px;">
  <div style="display: flex; flex-wrap: wrap; gap: 15px; justify-content: center;">
    <!-- New Unit 3 Boxes -->
    <a href="https://huggingface.co/learn/mcp-course/unit3/introduction" style="text-decoration: none; color: inherit; width: 100%; height: 120px; margin-bottom: 10px; margin-top: 10px;">
      <div style="padding: 15px; border-radius: 8px; background-image: linear-gradient(to bottom, #e6f7ff, #cce5ff); box-shadow: 1px 1px 3px rgba(0,0,0,0.1); border: 2px solid #3498db; height: 100%; display: flex; justify-content: space-between; align-items: center; transition: all 0.3s ease;" onmouseover="this.style.transform='scale(1.02)'; this.style.boxShadow='2px 2px 8px rgba(0,0,0,0.2)'; this.style.backgroundImage='linear-gradient(to bottom, #d6f0ff, #b8daff)';" onmouseout="this.style.transform='scale(1)'; this.style.boxShadow='1px 1px 3px rgba(0,0,0,0.1)'; this.style.backgroundImage='linear-gradient(to bottom, #e6f7ff, #cce5ff)';">
        <div>
          <h3 style="margin-top: 10; color: #000000;">🚀 Unit 3 is here!</h3>
          <p style="color: #000000;">Build a production ready MCP application with Anthropic, Slack, and Github integration. Learn to create robust, scalable MCP applications ready for real-world deployment.</p>
        </div>
        <img src="images/anthropic.png" alt="Production Icon" style="height: 100%; width: auto; margin-left: 10px;">
      </div>
    </a>
    <a href="https://huggingface.co/learn/mcp-course/unit3_1/introduction" style="text-decoration: none; color: inherit; width: 100%; height: 120px; margin-bottom: 10px; margin-top: 10px;">
      <div style="padding: 15px; border-radius: 8px; background-image: linear-gradient(to bottom, #e6f7ff, #cce5ff); box-shadow: 1px 1px 3px rgba(0,0,0,0.1); border: 2px solid #3498db; height: 100%; display: flex; justify-content: space-between; align-items: center; transition: all 0.3s ease;" onmouseover="this.style.transform='scale(1.02)'; this.style.boxShadow='2px 2px 8px rgba(0,0,0,0.2)'; this.style.backgroundImage='linear-gradient(to bottom, #d6f0ff, #b8daff)';" onmouseout="this.style.transform='scale(1)'; this.style.boxShadow='1px 1px 3px rgba(0,0,0,0.1)'; this.style.backgroundImage='linear-gradient(to bottom, #e6f7ff, #cce5ff)';">
        <div>
          <h3 style="margin-top: 10; color: #000000;">🤖 Unit 3.1 for the Hub</h3>
          <p style="color: #000000;">Build autonomous agents on the Hugging Face Hub. Create intelligent agents that can operate independently using MCP protocols.</p>
        </div>
        <img src="images/pr-agent.png" alt="Agent Icon" style="height: 100%; width: auto; margin-left: 10px;">
      </div>
    </a>
    <a href="https://huggingface.co/learn/mcp-course/unit2/continue-client" style="text-decoration: none; color: inherit; width: 100%; height: 120px; margin-bottom: 10px; margin-top: 10px;">
      <div style="padding: 15px; border-radius: 8px; background-image: linear-gradient(to bottom, #e6f7ff, #cce5ff); box-shadow: 1px 1px 3px rgba(0,0,0,0.1); border: 2px solid #3498db; height: 100%; display: flex; justify-content: space-between; align-items: center; transition: all 0.3s ease;" onmouseover="this.style.transform='scale(1.02)'; this.style.boxShadow='2px 2px 8px rgba(0,0,0,0.2)'; this.style.backgroundImage='linear-gradient(to bottom, #d6f0ff, #b8daff)';" onmouseout="this.style.transform='scale(1)'; this.style.boxShadow='1px 1px 3px rgba(0,0,0,0.1)'; this.style.backgroundImage='linear-gradient(to bottom, #e6f7ff, #cce5ff)';">
        <div>
          <h3 style="margin-top: 10; color: #000000;">🤖 Using MCP with Local and Open Source Models</h3>
          <p style="color: #000000;">In this section, we’ll connect MCP with local and open-source models using Continue, a tool for building AI coding assistants that works with local tools like Ollama.</p>
        </div>
        <img src="images/continue.png" alt="Agent Icon" style="height: 100%; width: auto; margin-left: 10px;">
      </div>
    </a>
    <!-- Divider -->
    <div style="width: 100%; height: 2px; background: linear-gradient(to right, transparent, #ccc, transparent); margin: 20px 0;"></div>
    <!-- Existing boxes with grey styling -->
    <a href="https://youtu.be/p4q6LI-2yZ8" style="text-decoration: none; color: inherit; width: 100%; height: 120px; margin-bottom: 10px; margin-top: 10px;">
      <div style="padding: 15px; border-radius: 8px; background-image: linear-gradient(to bottom, #f0f0f0, #e0e0e0); box-shadow: 1px 1px 3px rgba(0,0,0,0.1); border: 2px solid #888888; height: 100%; display: flex; justify-content: space-between; align-items: center; transition: all 0.3s ease;" onmouseover="this.style.transform='scale(1.02)'; this.style.boxShadow='2px 2px 8px rgba(0,0,0,0.2)'; this.style.backgroundImage='linear-gradient(to bottom, #e8e8e8, #d8d8d8)';" onmouseout="this.style.transform='scale(1)'; this.style.boxShadow='1px 1px 3px rgba(0,0,0,0.1)'; this.style.backgroundImage='linear-gradient(to bottom, #f0f0f0, #e0e0e0)';">
        <div>
          <h3 style="margin-top: 10; color: #000000;">🎬 Unit 0 Video</h3>
          <p style="color: #000000;">Complete Introduction to The first parts of the MCP Course. This video is a must-watch for everyone who wants to start the MCP Course.</p>
        </div>
        <img src="images/video_1.png" alt="Video Icon" style="height: 100%; width: auto; margin-left: 10px;">
      </div>
    </a>
    <a href="https://youtube.com/live/aK8Jz-x5rJ8?feature=share" style="text-decoration: none; color: inherit; width: 100%; height: 120px; margin-bottom: 10px; margin-top: 10px;">
      <div style="padding: 15px; border-radius: 8px; background-image: linear-gradient(to bottom, #f0f0f0, #e0e0e0); box-shadow: 1px 1px 3px rgba(0,0,0,0.1); border: 2px solid #888888; height: 100%; display: flex; justify-content: space-between; align-items: center; transition: all 0.3s ease;" onmouseover="this.style.transform='scale(1.02)'; this.style.boxShadow='2px 2px 8px rgba(0,0,0,0.2)'; this.style.backgroundImage='linear-gradient(to bottom, #e8e8e8, #d8d8d8)';" onmouseout="this.style.transform='scale(1)'; this.style.boxShadow='1px 1px 3px rgba(0,0,0,0.1)'; this.style.backgroundImage='linear-gradient(to bottom, #f0f0f0, #e0e0e0)';">
        <div>
          <h3 style="margin-top: 10; color: #000000;">🔴 Unit 1 Live Stream</h3>
          <p style="color: #000000;">On <b style="color: #000000;">29th May 8:00 PM CEST</b> we will have a live stream where we will cover Q&A and the MCP Course Unit 1 on MCP fundamentals. </p>
        </div>
        <img src="images/live_session.png" alt="Live Stream Icon" style="height: 100%; width: auto; margin-left: 10px;">
      </div>
    </a>
    <a href="https://huggingface.co/spaces/mcp-course/unit_1_quiz" style="text-decoration: none; color: inherit; width: 100%; height: 120px; margin-bottom: 10px; margin-top: 10px;">
      <div style="padding: 15px; border-radius: 8px; background-image: linear-gradient(to bottom, #f0f0f0, #e0e0e0); box-shadow: 1px 1px 3px rgba(0,0,0,0.1); border: 2px solid #888888; height: 100%; display: flex; justify-content: space-between; align-items: center; transition: all 0.3s ease;" onmouseover="this.style.transform='scale(1.02)'; this.style.boxShadow='2px 2px 8px rgba(0,0,0,0.2)'; this.style.backgroundImage='linear-gradient(to bottom, #e8e8e8, #d8d8d8)';" onmouseout="this.style.transform='scale(1)'; this.style.boxShadow='1px 1px 3px rgba(0,0,0,0.1)'; this.style.backgroundImage='linear-gradient(to bottom, #f0f0f0, #e0e0e0)';">
        <div>
          <h3 style="margin-top: 10; color: #000000;">🏆 Get Certified</h3>
          <p style="color: #000000;">If you want to get certified, you can do so by completing the MCP Course and passing the certification exam.</p>
        </div>
        <img src="images/certificate.png" alt="Certificate Icon" style="height: 100%; width: auto; margin-left: 10px;">
      </div>
    </a>
    <a href="https://huggingface.co/learn/mcp-course/unit0/introduction" style="text-decoration: none; color: inherit; width: 100%; height: 120px; margin-bottom: 10px; margin-top: 10px; margin-bottom: 30px;">
      <div style="padding: 15px; border-radius: 8px; background-image: linear-gradient(to bottom, #f0f0f0, #e0e0e0); box-shadow: 1px 1px 3px rgba(0,0,0,0.1); border: 2px solid #888888; height: 100%; display: flex; justify-content: space-between; align-items: center; transition: all 0.3s ease;" onmouseover="this.style.transform='scale(1.02)'; this.style.boxShadow='2px 2px 8px rgba(0,0,0,0.2)'; this.style.backgroundImage='linear-gradient(to bottom, #e8e8e8, #d8d8d8)';" onmouseout="this.style.transform='scale(1)'; this.style.boxShadow='1px 1px 3px rgba(0,0,0,0.1)'; this.style.backgroundImage='linear-gradient(to bottom, #f0f0f0, #e0e0e0)';">
        <div>
          <h3 style="margin-top: 10; color: #000000;">📝 Written Materials</h3>
          <p style="color: #000000;">To start learning the MCP Course, you can start with the written materials.</p>
        </div>
        <img src="images/written_material.png" alt="Written Materials Icon" style="height: 100%; width: auto; margin-left: 10px;">
      </div>
    </a>
  </div>
</div>

<div style="width: 100%; border: 1px solid #ccc; padding: 20px; margin: 20px auto; box-shadow: 2px 2px 5px rgba(0, 0, 0, 0.1); background-image: linear-gradient(to bottom, #ffd231, #ff9d00); border-radius: 8px;">
  <img src="https://cdn-avatars.huggingface.co/v1/production/uploads/62d648291fa3e4e7ae3fa6e8/Jm3GYn6LHuasiLSlj03hd.png" alt="MCP Course" style="width: 7em; border-radius: 5px 5px 0 0;">
  <h2 style="color: #333; margin-bottom: 10px;">🚀 Ready to Join? Enroll in the MCP Course!</h2>
  <a href="https://huggingface.co/organizations/mcp-course/share/BcsYJAxCofWDZncivkBzafSjAcuAxOMWua" style="display: inline-block; padding: 10px 20px; background-color: lightcoral; color: white; text-decoration: none; border-radius: 5px; transition: background-color 0.3s ease;" onmouseover="this.style.backgroundColor='#0056b3'" onmouseout="this.style.backgroundColor='lightcoral'">Join the Course</a>
</div>

## 🚀 What to Expect from This Course?

In this course, you will:

*   📖 **Study Model Context Protocol** in theory, design, and practice.
*   🧑‍💻 Learn to **use established MCP SDKs and frameworks**.
*   💾 **Share your projects** and explore applications created by the community.
*   🏆 Participate in challenges and **evaluate your MCP implementations**.
*   🎓 **Earn a certificate of completion** by completing assignments.

Our goal is to help you understand how MCP works and empower you to build your own AI applications.

## 📚 Course Structure

The course is composed of:
*   **Foundational Units**: Learn MCP concepts in theory.
*   **Use Case Assignments**: Apply learned concepts to real-world problems.
*   **Collaborations**: Featuring the latest MCP implementations and tools from Hugging Face and its partners.

## 🛠️ Prerequisites

To be able to follow this course, you should have:

*   Basic understanding of AI and LLM concepts.
*   Familiarity with software development principles and API concepts.
*   Experience with at least one programming language (Python or TypeScript examples will be shown).

If you need to brush up on these, the course page suggests these resources:
*   LLM Course: will guide you through the basics of using and building with LLMs.
*   Agents Course: will guide you through building AI agents with LLMs.
(Please find the links to these specific courses in the main MCP course materials if needed.)

## 🤝 Contribute

This course is a living project, and **contributions are welcome** 🤗!
*   If you've found a bug or want to improve the course content, please open an issue or a Pull Request in the course's GitHub repository (refer to the course documentation for the specific GitHub link).
*   If you want to add a full section or a new unit, it's best to open an issue first to discuss your ideas with the team.

## ❓ Questions?

Please open a community discussion on the org page.

<div style="width: 100%; border: 1px solid #ccc; padding: 20px; margin: 20px auto; box-shadow: 2px 2px 5px rgba(0, 0, 0, 0.1); background-image: linear-gradient(to bottom, #add8e6, #87ceeb); border-radius: 8px;">
  <img src="https://cdn-avatars.huggingface.co/v1/production/uploads/62d648291fa3e4e7ae3fa6e8/Jm3GYn6LHuasiLSlj03hd.png" alt="Course Materials" style="width: 7em; border-radius: 5px 5px 0 0;">
  <h2 style="color: #333; margin-bottom: 10px;">📚 Explore the Course Content</h2>
  <a href="https://huggingface.co/learn/mcp-course/unit0/introduction" style="display: inline-block; padding: 10px 20px; background-color: #5cb85c; color: white; text-decoration: none; border-radius: 5px; transition: background-color 0.3s ease;" onmouseover="this.style.backgroundColor='#4cae4c'" onmouseout="this.style.backgroundColor='#5cb85c'">Access the Full Course</a>
</div>