Skip to content

Update MCP Security Whitepaper for 2026-07-28 #106

@imolloy

Description

@imolloy

Summary

The MCP specification published its 2026-07-28 release candidate,
introducing significant architectural changes to the protocol. The WS4 white paper
and any associated guidance documents that reference MCP should be reviewed and
updated to accurately reflect the current specification.

Tasks

Protocol Architecture

  • Update session model guidance — initialize/initialized handshake and
    Mcp-Session-Id are eliminated; client metadata now travels via _meta on every
    request. Review any security guidance around session establishment and sticky sessions.
  • Update server-to-client request documentation — server-initiated requests are
    now restricted to occur only while the server is actively processing a client
    request; InputRequiredResult (Multi-Round-Trip Requests) replaces SSE streams.

Extensions Framework

  • Add coverage of the formalized Extensions Framework — reverse-DNS identifiers,
    independent versioning, delegated maintainers, and the Extensions Track in the
    SEP process.
  • Add or update guidance on the MCP Apps extension — server-rendered UIs
    delivered in sandboxed iframes, including security implications (sandboxing model,
    audit trail via JSON-RPC layer).
  • Add or update guidance on the Tasks extension — graduated from experimental;
    covers tool-call-to-task-handle lifecycle, tasks/get, tasks/update,
    tasks/cancel.

Authorization & Security

  • Update OAuth 2.0 / OIDC guidance to reflect the six SEP hardening changes:
    • Required iss parameter validation (RFC 9207)
    • application_type declaration in Dynamic Client Registration
    • Credential binding to issuing authorization servers
    • Refresh token and scope accumulation procedures

Operational Concerns

  • Document Mcp-Method and Mcp-Name header semantics and their implications
    for routing, observability, and threat modeling.
  • Add caching guidance — ttlMs / cacheScope response caching parameters and
    their security/privacy trade-offs.
  • Update distributed tracing guidance to reference W3C Trace Context propagation
    as now formally specified.

Deprecations

  • Update or remove guidance on Roots (deprecated; replaced by tool parameters
    or server configuration).
  • Update or remove guidance on Sampling (deprecated; direct LLM provider API
    integration preferred).
  • Update or remove guidance on Logging (deprecated; stderr or OpenTelemetry
    recommended). Note: twelve-month deprecation window applies.

Schema & Error Handling

  • Update tool schema guidance to reflect full JSON Schema 2020-12 support
    (oneOf, anyOf, allOf, conditionals, $ref).
  • Update error code references — missing resource error changes from -32002 to
    JSON-RPC standard -32602.

References

Metadata

Metadata

Assignees

No one assigned

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions