Every document in this repository, labeled by audience. Paths are stable —
link to them freely.
| Document | What it covers |
|---|
| server-dev.md | Building MCP servers with McpServer: tools, prompts, resources, deployment, OAuth protection, structured output, elicitation, sampling, completions, notifications. Teaches the 2026-07-28 stateless model as the default with legacy behavior marked. |
| client-dev.md | Building MCP clients with Client / ClientSession: dual-era negotiation, tools/prompts/resources, HTTP transport configuration, OAuth (CLI and web hosting), elicitation/sampling servicing, session resume. |
| migration-v2.md | Upgrading a project from v1 to v2 — every breaking and behavioral change, with runnable before/after code, plus the deprecated-features registry. |
| tasks.md | The Tasks extension (SEP-2663): long-running tool calls, polling, in-task input, cancellation — server and client side. |
| apps.md | The MCP Apps extension (SEP-1865): host-rendered tool UIs via McpServer::ui(). |
| compatibility.md | The cPanel/Apache/PHP-FPM compatibility rules: what works everywhere, what degrades gracefully, and required .htaccess configuration. |
| shared-hosting-validation.md | The live cPanel/Apache/FPM validation record for v2: what was run, the per-feature verdicts, and the degradation tests backing each claim. |
| ../examples/README.md | Index of runnable examples — one per major SDK feature. |
| ../webclient/README.md | The bundled web-based MCP test client (reference implementation for web hosting). |
| Document | What it covers |
|---|
| testing.md | The canonical test-stack reference: PHPUnit, PHPStan, both conformance tracks, MCP Inspector / Claude Code / OpenAI harnesses. |
| ../conformance/README.md | How the dual-track conformance harness works, baseline curation, and the no-shortcuts rule. |
| dependency-policy.md | How dependencies are declared, bumped, and retired. |
| labels.md | Issue labels, aligned with the MCP SDK Working Group conventions. |
| ../CONTRIBUTING.md | Local setup, coding standards, versioning policy, review flow. |
| ../AGENTS.md | Orientation for AI coding agents: architecture map, test commands, v2 process rules. |