# MCP Tutor

Teaches one Model Context Protocol lesson at a time, recording wire evidence as it goes.

- Repository: https://github.com/rohitg00/ai-engineering-from-scratch (76237 stars)
- Category: AI and agents
- License: MIT
- Last updated: 2026-10-29
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add rohitg00/ai-engineering-from-scratch --skill learn-mcp -g -a claude-code -y`
Codex: `npx skills add rohitg00/ai-engineering-from-scratch --skill learn-mcp -g -a codex -y`
Cursor: `npx skills add rohitg00/ai-engineering-from-scratch --skill learn-mcp -g -a cursor -y`
Gemini CLI: `npx skills add rohitg00/ai-engineering-from-scratch --skill learn-mcp -g -a gemini-cli -y`

## Description

Focused interactive tutor for the Model Context Protocol (MCP) path in AI Engineering from Scratch. Start or resume this route when a learner wants to build, secure, debug, verify, or operate MCP clients, servers, transports, gateways, registries, or conformance gates. Teaches one lesson per invocation and records wire evidence in MCP-LEARNING.md.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Learn Model Context Protocol (MCP)

Teach the focused Model Context Protocol (MCP) route. One invocation covers one lesson.
The learner should inspect a request and response, predict a boundary result,
run or hand-trace the lab, and record the lesson checkpoint before advancing.

## Use the invocation syntax of the host

The portable skill name is `learn-mcp`. Do not present one host's
syntax as a protocol rule.

| Host | Start or resume |
|---|---|
| Codex | `learn-mcp`, or choose it from `/skills` |
| Claude Code | `/learn-mcp` |
| Other compatible hosts | `Use learn-mcp to start or resume the Model Context Protocol (MCP) path.` |

## Read the route before selecting a lesson

The source of truth is `learning-paths/model-context-protocol.json`. Prefer local
files when this repository is available. Otherwise fetch a needed file from:

```text
https://raw.githubusercontent.com/rohitg00/ai-engineering-from-scratch/main/<path>
```

Follow the manifest's `lessons` array by `order`. The required sequence is 06,
07, 08, 09, 10, 11, 12, 13, 14, 15, 16, 18, 17, 28, 29, 30, 31. Numeric next
navigation is not the route after Lesson 16.

For the selected lesson, read `docs/en.md` and `quiz.json` fully. Read or run
`code/` and `outputs/` only when the current teaching step needs them. Use the
lesson's stated protocol era. Never merge a legacy handshake rule into a
modern stateless trace.

Lesson 23 is the only optional capstone. Offer it only after all required rows
are complete and both manifest `prerequisitePaths`, Lessons 19 and 20, are
complete. Do not silently add another lesson to this path.

## Establish the evidence mode

Before the first executable checkpoint, determine whether:

1. The lesson files are available locally.
2. `python3 --version` succeeds.
3. The learner can write `MCP-LEARNING.md` in the current working
   directory.
4. A TypeScript runner is available if the learner chooses the optional second
   implementation in Lesson 07.

The rest: https://github.com/rohitg00/ai-engineering-from-scratch/blob/HEAD/.claude/skills/learn-mcp/SKILL.md