mcp-migration-auditorlisted
Install: claude install-skill Abhillashjadhav/AI-PM-essential-skills
# MCP Migration Auditor
Scan MCP server configs against the verified breaking changes in the MCP **2026-07-28** specification and report exactly which servers break, which degrade, and which are safe — with the rule and official source behind every verdict.
**The clock:** the release candidate locked May 21, 2026; the final specification ships **July 28, 2026**. Every rule below comes from the official announcement and spec changelog — full quotes and URLs in `references/spec-changes.md`. If a check isn't in that file, this skill doesn't make it.
## Step 1 — Locate configs
Search the project for MCP configs, in this order: `.mcp.json`, `mcp.json`, `claude_desktop_config.json`, `mcpServers` blocks inside `.claude/settings.json` / `.claude/settings.local.json` / other settings files. If none found, ask the user to paste one — never audit an imagined config.
## Step 2 — Classify transport per server
- `command`-based entries → **stdio/local**. Per the official announcement, stdio and local transports "operate independently of Streamable HTTP statelessness requirements and session infrastructure changes" — these start at SAFE.
- `url`-based entries (HTTP / Streamable HTTP / SSE) → remote. These get the full rule pass.
## Step 3 — Apply the verified rules
| Rule | Evidence to look for | Verdict | Source |
|---|---|---|---|
| **R1 — Protocol session dependency** | `Mcp-Session-Id` in headers, session-affinity/sticky-session settings, session-store references for an MCP endp