Start here · a visual guide for curious minds

Agentic AI, APIs & MCP

The three big ideas behind modern AI — explained with analogies, pictures, and a build-it-yourself walkthrough. No jargon left standing.

1

Agentic AI

The one-sentence version: a normal AI answers — an agentic AI gets things done. You give it a goal, and it figures out the steps, uses tools, checks its own work, and keeps going until the goal is met.

A friendly robot given the goal, breaking it into a think-act-check-repeat loop and using tools like a calendar, magnifier, and gear.
Agentic AI: one goal in → a loop of thinking and tool-use → the job done.

The analogy — a vending machine vs. an intern

A regular chatbot is a vending machine: put in a question, a snack pops out. One shot, done. An agentic AI is a new intern: say “Plan the office party,” and they make a to-do list, book the room, order pizza, text everyone, and come back when it's finished.

The loop that makes it "agentic"

1. Think — break the goal into steps 2. Act — use a tool 3. Check — did it work? 4. Repeat — until done
Everyday example: You say “Find the cheapest flight to New York next Friday and put it on my calendar.” It searches flights (tool 1) → compares prices (thinking) → picks the cheapest → adds a calendar event (tool 2) → tells you it's done. One goal, five actions. That's agentic.

The key idea: agents need tools to actually do things in the real world. That's exactly where APIs and MCP come in. 👇

Want the code behind this loop? The Week 1 deep dive takes it apart line by line and runs it live in your browser.

2

API Calls

Theory: an API (Application Programming Interface) is a messenger that lets two pieces of software talk using agreed-upon rules. An API call is one round-trip: you send a request, you get back a response.

Restaurant analogy for an API: your app is the customer, the API is the waiter carrying a request, the server is the kitchen sending back a response.
An API is the waiter between your app and the kitchen (the server).

The analogy — a waiter at a restaurant

You (your app) are the customer. The kitchen is a giant server you can't walk into. The API is the waiter: you give your order (the request); the waiter brings your food (the response). You never need to know how the kitchen cooks — just how to order.

A real example — weather

Your weather app doesn't own a satellite. It makes an API call:

REQUEST:   GET weather for Austin, TX

RESPONSE:  { "temp": 98, "sky": "sunny", "humidity": 40 }

The reply comes back as tidy data (usually JSON, like above). Every refresh is another API call. You already use them constantly: “Log in with Google,” a live game leaderboard, or Google Maps inside Uber — all API calls.

On the Build It page you'll create this exact weather API yourself in 6 lines.

3

MCP — Model Context Protocol

Theory: MCP is a universal standard that lets an AI connect to tools, apps, and data — all in the same way. Instead of a custom connection per tool, MCP gives every tool one shared plug shape.

MCP as a universal USB-C plug: one AI assistant connects through a single standard port to many tools — Mail, Calendar, Browser, Image, Weather, Database.
MCP is USB-C for AI: one universal port into many different tools.

The analogy — USB-C

Remember when every phone had a different charger? Then USB-C arrived — one plug for laptop, phone, headphones, monitor. Before MCP, every AI-to-tool link was a custom cable (Gmail? build one. Calendar? build another). With MCP, tools expose themselves through one standard port, so any MCP-speaking AI plugs in instantly. Build it once, works everywhere.

Right now: the assistant that generated the pictures on this page is connected through MCP to an image generator, plus Gmail, Notion, a web browser and more — no hand-built integration for each. That's why it can pick up lots of tools fast, which is exactly what makes an agent powerful.
4

API vs MCP

They're not rivals — MCP usually uses APIs underneath. But they solve different problems.

Side by side: API is a single custom cable between one app and one service; MCP is a universal hub connecting one AI to many tools. MCP uses APIs underneath.
An API is one door. MCP is a universal door frame — and behind many doors, an API still does the work.
APIMCP
What it isA messenger between two specific programsA universal standard connecting AIs to many tools
AnalogyA waiter for one restaurantUSB-C — one plug for everything
Built forSoftware talking to softwareAI models talking to tools
EffortCustom-built for each pairingBuild once, works with any MCP AI
Who "speaks" itDevelopers writing codeThe AI model itself, on the fly
💡 Remember this: an API is a door between two rooms. MCP is a standard door frame so an AI can open any room's door the same way — and behind many of those doors, an API is still doing the actual work.
5

Set One Up & Watch It Work

No coding required to start. Three tiers, easiest first.

🥇 Easiest — watch an agent + MCP right now (0 setup)

Open any modern AI assistant (like Claude) and ask:

"Search the web for today's top science headline,
 then make me an image about it."

Watch it think (plan) → call a web tool via MCP → call an image tool via MCP → hand you the result. That chain — goal → tools → result — is an agent using MCP. You just watched it. 🎉

🥈 See a raw API call with your own eyes (~2 min, no code)

  1. Paste this into your browser:
    https://official-joke-api.appspot.com/random_joke
  2. Hit Enter. The raw JSON response appears — exactly what an app receives from an API call.
  3. Refresh a few times — each refresh is a new API call returning new data.

🏆 Build your own API + MCP + agent (~20 min)

Ready to make all three yourself, with one small weather example that threads through every step? That's the whole next page.

🛠️ Build API → MCP → Agent →

📌 Recap in one breath

  • Agentic AI — give it a goal; it plans, uses tools, and checks itself in a loop.
  • API call — a waiter carrying a request/response between two programs.
  • MCP — USB-C for AI: one universal way to plug an AI into many tools.
  • API vs MCP — a specific door vs. a universal door frame (MCP often uses APIs behind the scenes).
🛠️ Build it yourself → Start Week 1 →