Document v0.6.0 changes in CHANGELOG and docs

Wrap-up for the v0.6.0 release: capture features/BC breaks merged since
v0.5.0 that were missing from documentation.

- CHANGELOG: add the `title` field on `Resource`/`ResourceTemplate` (#301),
  a feature plus three positional-argument BC breaks.
- mcp-elements.md: add the missing `title` parameter to the McpTool,
  McpResource, McpResourceTemplate and McpPrompt attribute reference
  sections; fix a missing closing paren in an `#[McpPrompt]` example.
- server-builder.md: add `title?` to the `addPrompt()` row of the method
  reference table (stale since v0.5.0).
- client.md: bump the protocol-version example to `V2025_11_25` to match
  the new default.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: chr-hertel

CHANGELOG.md

@@ -14,6 +14,7 @@ All notable changes to `mcp/sdk` will be documented in this file.
 * Add `extensions` to `ServerCapabilities` and `ClientCapabilities` and `Builder::enableExtension()`
 * Allow overriding the default name pattern for Discovery
 * Add configurable session garbage collection (`gcProbability`/`gcDivisor`)
+* Add optional `title` field to `Resource` and `ResourceTemplate` for MCP spec compliance
 * Add `ChainLoader` to compose multiple `LoaderInterface` implementations via explicit ordering.
 * Add `RegistryInterface::unregisterTool()`, `unregisterResource()`, `unregisterResourceTemplate()`, `unregisterPrompt()` — idempotent removals.
 * Add `RegistryInterface::hasTool()`, `hasResource()`, `hasResourceTemplate()`, `hasPrompt()` — by-name existence checks.
@@ -26,7 +27,10 @@ All notable changes to `mcp/sdk` will be documented in this file.
 * [BC Break] `Builder::addResource()` signature changed — `$title` parameter added between `$name` and `$description`. Callers using positional arguments must switch to named arguments.
 * [BC Break] `Builder::addResourceTemplate()` signature changed — `$title` parameter added between `$name` and `$description`. Callers using positional arguments must switch to named arguments.
 * Add `CorsMiddleware`, `DnsRebindingProtectionMiddleware`, and `ProtocolVersionMiddleware` for `StreamableHttpTransport`, composed automatically as the default stack via `StreamableHttpTransport::defaultMiddleware()`
-* **[BC BREAK]** `StreamableHttpTransport` constructor: `$corsHeaders` parameter removed; CORS is now configured via `CorsMiddleware`. The `$middleware` parameter is nullable — `null` (or omitted) installs the default stack; `[]` disables all defaults. Default `Access-Control-Allow-Origin` is no longer set (was `*`).
+* [BC BREAK] `StreamableHttpTransport` constructor: `$corsHeaders` parameter removed; CORS is now configured via `CorsMiddleware`. The `$middleware` parameter is nullable — `null` (or omitted) installs the default stack; `[]` disables all defaults. Default `Access-Control-Allow-Origin` is no longer set (was `*`).
+* [BC Break] `Resource::__construct()` signature changed — `$title` parameter added between `$name` and `$description`. Callers using positional arguments must switch to named arguments.
+* [BC Break] `ResourceTemplate::__construct()` signature changed — `$title` parameter added between `$name` and `$description`. Callers using positional arguments must switch to named arguments.
+* [BC Break] `McpResource` and `McpResourceTemplate` attribute signatures changed — `$title` parameter added between `$name` and `$description`. Callers using positional arguments must switch to named arguments.
 
 0.5.0
 -----

docs/client.md

@@ -83,7 +83,7 @@ Specify the MCP protocol version (defaults to latest):
 use Mcp\Schema\Enum\ProtocolVersion;
 
 $client = Client::builder()
-    ->setProtocolVersion(ProtocolVersion::V2025_06_18)
+    ->setProtocolVersion(ProtocolVersion::V2025_11_25)
     ->build();
 ```
 

docs/mcp-elements.md

@@ -74,6 +74,7 @@ class Calculator
 ### Parameters
 
 - **`name`** (optional): Tool identifier. Defaults to method name if not provided.
+- **`title`** (optional): Human-readable display title shown in client UI. Distinct from `name`.
 - **`description`** (optional): Tool description. Defaults to docblock summary if not provided, otherwise uses method name.
 - **`annotations`** (optional): `ToolAnnotations` object for additional metadata.
 - **`icons`** (optional): Array of `Icon` objects for visual representation.
@@ -219,7 +220,8 @@ class ConfigProvider
 ### Parameters
 
 - **`uri`** (required): Unique resource identifier. Must comply with [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986).
-- **`name`** (optional): Human-readable name. Defaults to method name if not provided.
+- **`name`** (optional): Short resource identifier. Defaults to method name if not provided.
+- **`title`** (optional): Human-readable display title shown in client UI. Distinct from `name`.
 - **`description`** (optional): Resource description. Defaults to docblock summary if not provided.
 - **`mimeType`** (optional): MIME type of the resource content.
 - **`size`** (optional): Size in bytes if known.
@@ -367,7 +369,8 @@ class UserProvider
 ### Parameters
 
 - **`uriTemplate`** (required): URI template with `{variables}` using RFC 6570 syntax. Must comply with RFC 3986.
-- **`name`** (optional): Human-readable name. Defaults to method name if not provided.
+- **`name`** (optional): Short resource template identifier. Defaults to method name if not provided.
+- **`title`** (optional): Human-readable display title shown in client UI. Distinct from `name`.
 - **`description`** (optional): Template description. Defaults to docblock summary if not provided.
 - **`mimeType`** (optional): MIME type of the resource content.
 - **`annotations`** (optional): Additional metadata.
@@ -393,7 +396,7 @@ class PromptGenerator
     /**
      * Generates a code review request prompt.
      */
-    #[McpPrompt(name: 'code_review']
+    #[McpPrompt(name: 'code_review')]
     public function reviewCode(string $language, string $code, string $focus = 'general'): array
     {
         return [
@@ -407,6 +410,7 @@ class PromptGenerator
 ### Parameters
 
 - **`name`** (optional): Prompt identifier. Defaults to method name if not provided.
+- **`title`** (optional): Human-readable display title shown in client UI. Distinct from `name`.
 - **`description`** (optional): Prompt description. Defaults to docblock summary if not provided.
 - **`icons`** (optional): Array of `Icon` objects for visual representation.
 - **`meta`** (optional): Arbitrary key-value pairs for custom metadata.

docs/server-builder.md

@@ -673,6 +673,6 @@ $server = Server::builder()
 | `addTool()` | handler, name?, title?, description?, annotations?, inputSchema?, ... | Register tool |
 | `addResource()` | handler, uri, name?, description?, mimeType?, size?, annotations? | Register resource |
 | `addResourceTemplate()` | handler, uriTemplate, name?, description?, mimeType?, annotations? | Register resource template |
-| `addPrompt()` | handler, name?, description? | Register prompt |
+| `addPrompt()` | handler, name?, title?, description?, icons?, meta? | Register prompt |
 | `add()` | definition, handler | Register an element from a schema VO + handler pair |
 | `build()` | - | Create the server instance |