Skip to content

[Docs] SEP-2596: Adopt MCP feature lifecycle policy; document PHP SDK BC promise mirroring 12-month spec window #366

Description

@chr-hertel

Implements SEP-2596 for the MCP Spec 2026-07-28 release.

Tracked by umbrella #339.

Spec summary

Establishes formal Active → Deprecated → Removed lifecycle for spec features with a minimum 12-month window between deprecation and earliest removal, mandatory @deprecated schema annotations + changelog entries, and a two-SEP procedure (deprecation and removal each get their own SEP).

PHP SDK changes

  • Adopt the same lifecycle policy in the SDK: PHP @deprecated tags must mirror spec-level @deprecated annotations, with the spec version that introduced deprecation noted (e.g., @deprecated Since spec 2026-07-28; will be removed no earlier than 2027-07-28).
  • Audit any informal deprecations in Schema/ (e.g., legacy HTTP+SSE transport, includeContext: thisServer|allServers enum values) and document their lifecycle status.
  • Establish an internal SDK policy doc — likely docs/deprecation-policy.md or BC_PROMISE.md — anchoring the PHP SDK BC promise to the 12-month spec window. Aligns naturally with Symfony's BC promise.
  • Add a CI lint / static-analysis check that every spec-level deprecated element has a corresponding PHP @deprecated tag.

Related

Metadata

Metadata

Assignees

No one assigned

    Labels

    2026-07-28All issues and PRs related to the spec release 2026-07-28P1Significant bug affecting many users, highly requested featuredocumentationImprovements or additions to documentationenhancementRequest for a new feature that's not currently supportedimproves spec complianceImproves consistency with other SDKs such as TyepScript

    Type

    No type

    Projects

    Status
    Todo

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions