Skip to content

Update MCP protocol expert agent for 2025-11-25 spec#4099

Merged
JAORMX merged 1 commit intomainfrom
update-mcp-protocol-expert-2025-11-25
Mar 11, 2026
Merged

Update MCP protocol expert agent for 2025-11-25 spec#4099
JAORMX merged 1 commit intomainfrom
update-mcp-protocol-expert-2025-11-25

Conversation

@JAORMX
Copy link
Copy Markdown
Collaborator

@JAORMX JAORMX commented Mar 11, 2026

Summary

The MCP protocol expert agent had several gaps compared to the actual 2025-11-25 specification. A full deep-dive review of every spec page (overview, transports, lifecycle, tasks, elicitation, tools, authorization, security best practices, schema) revealed missing protocol details that could lead the agent to give incomplete or incorrect guidance.

Key areas updated:

  • Transport: SSE stream closure/polling behavior, retry field, session DELETE, Accept header requirement, protocol version fallback rules
  • Lifecycle: Extended clientInfo/serverInfo fields (title, description, icons, websiteUrl), per-request timeout configuration
  • Tasks: Experimental designation, two-phase response pattern, input_required handling, task security (context binding, access control), error codes, tasks/result semantics
  • Elicitation: Statefulness requirements, backwards compatibility for empty capability, multi-select enum, phishing prevention, secure URL opening
  • Tools (new section): outputSchema, structuredContent, title, icons, execution.taskSupport, AudioContent, tool name constraints
  • Authorization: Scope selection strategy, step-up authorization, OIDC discovery requirement, detailed well-known URI fallback chain, SSRF protection
  • Security: New SSRF section, expanded confused deputy/session hijacking/scope minimization details
  • Base protocol: _meta key format (reverse DNS prefix), JSON Schema 2020-12 default, content types with AudioContent, icon specification
  • Resources: Added architecture, base protocol, tools, schema URLs; added llms.txt index and TypeScript schema source of truth

Type of change

  • Documentation

Test plan

  • Manual testing (describe below)

Reviewed every section of the updated file against the fetched spec pages to verify accuracy. Cross-referenced all URLs. Verified the file parses correctly as a Claude Code agent definition.

Does this introduce a user-facing change?

No. This only affects the MCP protocol expert AI subagent's knowledge base.

Generated with Claude Code

Deep-dive review of the MCP 2025-11-25 specification revealed several
gaps in the agent's protocol knowledge. This update ensures the agent
has accurate, comprehensive guidance covering all spec sections.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@github-actions github-actions bot added the size/S Small PR: 100-299 lines changed label Mar 11, 2026
@codecov
Copy link
Copy Markdown

codecov bot commented Mar 11, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 68.56%. Comparing base (0ad68d6) to head (f736e60).
⚠️ Report is 4 commits behind head on main.

Additional details and impacted files
@@           Coverage Diff           @@
##             main    #4099   +/-   ##
=======================================
  Coverage   68.56%   68.56%           
=======================================
  Files         448      448           
  Lines       45779    45779           
=======================================
  Hits        31389    31389           
+ Misses      11967    11966    -1     
- Partials     2423     2424    +1     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

@JAORMX JAORMX merged commit b2d92e7 into main Mar 11, 2026
39 of 40 checks passed
@JAORMX JAORMX deleted the update-mcp-protocol-expert-2025-11-25 branch March 11, 2026 16:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

size/S Small PR: 100-299 lines changed

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants