Build a Course FAQ Agent with MCP, PydanticAI and OpenAI
Continue with the workshop writeup
Open the canonical pages, recording, materials, and code repo.
We build a course FAQ assistant from the bottom up. First we expose a
plain Python search(query) function to the OpenAI Responses API. Then
we turn the same idea into a reusable agent loop and compare toyaikit,
OpenAI Agents SDK, and PydanticAI. Finally we move the FAQ tools behind
an MCP server. From there a notebook, PydanticAI, Cursor, and VS Code can
all reach them.
Links
The main resources:
- AI Bootcamp: From RAG to Agents
- Prerequisite workshop: Building a Coding Agent
- Data Engineering Zoomcamp FAQ source document
- Parsed FAQ JSON
- FAQ parsing notebook
The system you will build
The final setup looks like this:
The FAQ data comes from the Data Engineering Zoomcamp FAQ. The first
half of the workshop keeps the tools inside the notebook so you can see
the agent loop directly. The second half moves the same tools into
mcp_faq/, which makes them reusable by any MCP client.
Hosted by
Alexey Grigorev
Chief Agent Officer at AI Shipping Labs
Software engineer and machine learning practitioner with 15+ years of experience building production ML systems. I focus on practical, production-grade ML and AI systems, from early prototypes to reliable systems in production.
I'm the founder of DataTalks.Club, a free community that connects tens of thousands of practitioners worldwide, and the creator of the Zoomcamp series, free, code-first programs that have reached 100,000+ learners globally.
At AI Shipping Labs, I'm building the kind of environment that would have accelerated my own career growth. After years of teaching at scale, I wanted something more focused: a space for action-oriented builders who want to turn AI ideas into real projects. The community gives members the structure, accountability, and peer support to ship practical AI products consistently, even alongside their main jobs.
Related content
Build a Documentation RAG Agent with Search Tools
We build a RAG system over real documentation and evolve it into an agentic search flow. For the knowledge base we use the Evidently AI documentation, a real set of Markdown files…
May 4, 2026
Build a Coding Agent with Tools, Skills and PydanticAI
We build a coding agent from scratch, starting with tool calls and an agentic loop. We add a skills system that loads reusable instruction files on demand, and the final version r…
April 21, 2026
Skills.md from Scratch: Build a Skill-Driven Coding Agent
A newer, combined version of this workshop is available: Coding Agent with Skills. We start from the coding agent in the prerequisite workshop. We turn it into a general-purpose c…
January 16, 2026