KetanShukla.dev
Ketan Shukla

MCP Developer & AI Systems Engineer

Ketan Shukla

I build the full stack around the Model Context Protocol: servers that expose tools, hosts that run the loop, gates that ask first, crews that delegate, and ledgers that refuse the bill.

5
MCP projects
5
deployed endpoints
5
open-source repos

Built in public

Five projects. One protocol.

A progressive stack of the Model Context Protocol, from the first server to a cost-aware host that refuses to overspend.

1
The server

MCP Server — Tools, Resources, and Prompts

A complete, working Model Context Protocol server built with Next.js and deployed to Vercel, with a hand-written route handler and a live playground.

  • 4 MCP tools, 1 resource, 1 prompt
  • Live playground + Streamable HTTP endpoint
  • Zod input validation with guard rails
  • Mermaid diagrams and executable examples in the repo
https://learn-mcp-5-year-old.vercel.app/api/mcp
$curl -X POST https://learn-mcp-5-year-old.vercel.app/api/mcp
POST body
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/list"
}
2
The host

MCP Host — The Agent Loop

The other half of the protocol: a host that reads plain English, picks tools across multiple MCP servers, runs them, and loops until it has an answer.

  • Hand-written agent loop with explicit stop_reason handling
  • MCP schema → Claude API translation layer
  • Multi-server namespacing to avoid tool collisions
  • Prompt caching that cuts input cost by ~47%
https://learn-mcp-agent-loop.vercel.app/api/toolbox
$curl -X POST https://learn-mcp-agent-loop.vercel.app/api/toolbox
POST body
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/list"
}
3
The gate

The Agent That Asks First

Same loop, plus a notebook, an "are you sure?", a report card, and a rewind button — so an agent can own a dangerous tool and a human can still sleep at night.

  • Host-owned approval gate — never trusts server hints
  • Postgres persistence for messages, pending calls, and traces
  • Regression eval suite that deliberately regresses to stay honest
  • Replay UI to watch any past run step by step
https://learn-mcp-agent-guard.vercel.app/api/jar
$curl -X POST https://learn-mcp-agent-guard.vercel.app/api/jar
POST body
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/list"
}
4
The crew

One Agent That Hires Help

A sub-agent is a tool that happens to think. This repo adds spawn_agent and measures when a crew is cheaper, better, or both compared to a lone agent.

  • Local spawn_agent tool that reuses the same loop
  • One approval queue for an entire tree of workers
  • partial_results and paused_children for safe resume
  • Token-cost comparison showing 0.56× price at scale
https://learn-mcp-agent-crew.vercel.app/api/pantry
$curl -X POST https://learn-mcp-agent-crew.vercel.app/api/pantry
POST body
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/list"
}
5
The ledger

The Host That Owns The Wallet

Sampling turns an MCP server into a client that asks your host to think for it. This repo adds a spend gate and a ledger so your host says no before the bill arrives.

  • Implements MCP sampling with stateless retry flow
  • Cost ceiling that refuses before any model call
  • Ledger rows for allowed and refused draws, tagged by server
  • $0 regression suite replayed from stored traces
https://learn-mcp-agent-ledger.vercel.app/api/kitchen
$curl -X POST https://learn-mcp-agent-ledger.vercel.app/api/kitchen
POST body
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/list"
}

About

I build end-to-end systems and ship them in public.

My work sits at the intersection of AI infrastructure and production engineering. Every project in this series is a deployed, open-source system with live endpoints, regression suites, and measured tradeoffs — not slide decks.

I also ship products outside the AI space. I founded Metronagon Media, a book-cover and series-branding studio, and I am a published author of 22 books across 3 series. That same obsession with clarity, finish, and long-term craft shows up in my engineering work.

If you are hiring for AI platform, agent infrastructure, or developer tooling, I can take a system from idea to deployed endpoint — and document the path from prototype to production.

Ship fast

Next.js + Vercel from day one. Live URLs, not slide decks.

Build safe

Approval gates, cost ceilings, evals, and replay as first-class features.

Document the work

READMEs with diagrams, numbers, and honest tradeoffs that survive handoff.

Think end-to-end

Server, host, gate, crew, wallet — the whole protocol stack.

Stack

Tools I use to build

A modern, type-safe stack chosen for production AI systems: fast iteration, clear contracts, and honest observability.

Frameworks

  • Next.js 16
  • React 19
  • Tailwind CSS v4
  • TypeScript

MCP / AI

  • Model Context Protocol
  • MCP SDK
  • mcp-handler
  • Anthropic SDK
  • Agent Loops
  • Multi-Agent Orchestration

Backend / Data

  • Vercel
  • Neon Postgres
  • Zod
  • JSON-RPC

Practices

  • Evals
  • Human-in-the-Loop
  • Cost Engineering
  • Observability