php-sdk/docs/index.md
Christopher Hertel 7fe88677ad
[Docs][Examples][CI] Document and gate the 2026-07-28 lifecycle (#457)
docs/stateless-lifecycle.md walks the revision end to end - per-request
_meta, server/discover, multi round-trip requests, caching and subscriptions
- and a runnable example on each side shows what that looks like in code.

CI matrixes both conformance roles over both revisions. --spec-version is
cumulative across the dated revisions, so 2025-11-25 covers the two before
it; 2026-07-28 is not cumulative with them and needs its own run against its
own baseline. The runner is pinned so a PR only goes red for reasons in the
PR, and conformance-weekly tracks the moving target instead - on both
revisions, since the draft scenarios ship only on the alpha dist-tag.

The Inspector cannot reach a modern-lifecycle server (it opens with
initialize), so the example is covered by integration tests instead: one
drives it with hand-built HTTP the way a conforming client would, one drives
it with this SDK's client, and one drives the single endpoint from both eras.
2026-08-19 03:24:17 +02:00

1.3 KiB

MCP PHP SDK Guides

  • MCP Elements — Core capabilities (Tools, Resources, Resource Templates, and Prompts) with registration methods.
  • Server Builder — Fluent builder class for creating and configuring MCP server instances.
  • Client — Client SDK for connecting to and communicating with MCP servers.
  • The 2026-07-28 Lifecycle — The stateless protocol revision: per-request metadata, server/discover, multi round-trip requests, caching and subscriptions.
  • Transports — STDIO and HTTP transport implementations with guidance on choosing between them.
  • Server-Client Communication — Methods for servers to communicate back to clients: sampling, logging, progress, and notifications.
  • Protocol Extensions — Opt-in protocol extensions announced during capability negotiation, including MCP Apps (HTML UI resources).
  • Authorization — OAuth and authorization setup for the HTTP transport.
  • Events — Hooking into the server lifecycle with PSR-14 events.
  • Examples — Example projects demonstrating attribute-based discovery, dependency injection, HTTP transport, and more.