What is negotiated during the MCP initialize handshake and what should happen on version mismatch? · Zenaique

Attempt it

Describe the MCP initialize/initialized handshake: what fields are exchanged, what is being negotiated, and what is the correct client behavior when the server proposes a protocol version the client does not support?

Free · 2 AI evals / day

Quick reference

TL;DR

The initialize request exchanges protocolVersion, clientInfo, and capabilities; the initialized notification gates normal traffic; an unsupported version must abort, not silently degrade.

Memory aid

Sign in for the mnemonic that makes this stick. See Pro pricing.

Easy to grasp

Think of two people meeting who speak slightly different dialects. Before they start working, they shake hands and agree: which dialect will we use, who am I, and what skills do I bring? The client says 'let us speak version 2025-06, here is my name, and I can do sampling and roots'. The server replies 'version 2025-06 works for me, and I offer tools and prompts'. Only after that handshake does the client say 'okay, I am ready' and real work begins. If the server answered in a dialect the client never learned, the right move is to politely end the meeting, not to nod along and guess. Pretending to understand leads to confusing mistakes later, where one side calls a feature the other never actually agreed to support.

Key concepts

Connection lifecycle Capability negotiation Protocol version negotiation

Detailed answer & concept explanation

~8 min read

Everything you need to truly understand this topic: intuition, mechanics, step by step explanation, code, formulas, and worked example. Click to expand.

Everything you need to truly understand this topic: intuition, mechanics, step by step explanation, code, formulas, and worked example.

Sign in for 5 free unlocks/day or go Pro for unlimited. See Pro pricing.

Quick scan · 2–4 min

Everything important, quickly.

5 min: the three initialize fields, capability negotiation as nested objects, initialized as the operational gate, version downgrade handling, and abort versus silent decay on mismatch.

Code example

json

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "initialize",
  "params": {
    "protocolVersion": "2025-06-18",
    "clientInfo": { "name": "claude-code", "version": "1.4.0" },
    "capabilities": {
      "roots": { "listChanged": true },
      "sampling": {}
    }
  }
}

Real-world examples

Real products, models, and research that use this idea.

Claude Code and Claude Desktop run this initialize handshake against every configured server at session start before exposing any tools to the model.
The official mcp-inspector tool surfaces the initialize exchange so you can read the negotiated protocolVersion and both capability sets while debugging.
Cursor and Zed, both MCP hosts in 2026, perform the same handshake, so a server written for one negotiates identically with the others.

Interviewer follow-ups

What an interviewer would ask next. Try answering before peeking at the approach.

QHow does capability negotiation interact with the listChanged notifications a server can emit later in a session?

Sign in or go Pro to see the approach for this follow-up.

QWhat concrete failures appear if a client skips initialized and immediately calls tools/list?

Sign in or go Pro to see the approach for this follow-up.

QHow should a host handle several connected servers that negotiate different protocol versions in the same session?

Sign in or go Pro to see the approach for this follow-up.

Don't say this

Red flags and common mistakes that signal junior thinking. Click to expand.

Most common mistake

Treating initialized as decorative and firing tools or prompts requests before it. The server is entitled to reject anything that arrives before the handshake completes.

Sign in or go Pro to see all red flags and common mistakes. See Pro pricing.

60-second cheat sheet

The night-before-the-interview bullets. Scan these on the way to the call.

Sign in for 5 unlocks/day or go Pro for unlimited revision sheets. See Pro pricing.

References

Primary sources. Skim if you want the original framing.