Skip to content

build(deps): bump mcp/sdk from 0.9.0 to 0.10.0 - #4919

Open
dependabot[bot] wants to merge 1 commit into
mainfrom
dependabot/composer/mcp/sdk-0.10.0
Open

dependabot[bot] wants to merge 1 commit into
mainfrom
dependabot/composer/mcp/sdk-0.10.0

Conversation

@dependabot

@dependabot dependabot Bot commented on behalf of github Nov 18, 2026

Copy link
Copy Markdown
Contributor

Bumps mcp/sdk from 0.9.0 to 0.10.0.

Release notes

Sourced from mcp/sdk's releases.

v0.10.0

What's Changed

TL;DR

  • The SDK is split into the Mcp\Schema, Mcp\Client and Mcp\Server namespaces, ahead of separate packages: most imports change
  • PHP 8.2 or higher is required, and JSON-RPC batches are gone
  • The client authorizes with OAuth: authorization code, client credentials, private_key_jwt and experimental cross-app access
  • Handshake-era servers over HTTP run without sessions unless Builder::setSession() is called, and sessions belong to the principal that opened them
  • Request handlers can run under an event loop (Revolt, ReactPHP) with the opt-in Builder::setFiberScheduler(), and stream their responses
  • Tool arguments keep their JSON types, and arguments that don't fit are answered with -32602
  • stdio works on Windows, in the server and the client

Namespaces

  • [BC Break] Split the root namespace into Mcp\Schema, Mcp\Client and Mcp\Server to prepare slicing them into separate packages; update your imports. Mcp\Schema depends on nothing, Mcp\Client and Mcp\Server depend on Mcp\Schema only — enforced by Deptrac (make deptrac).
    • Mcp\Server => Mcp\Server\Server
    • Mcp\Client => Mcp\Client\Client
    • Mcp\Capability\* => Mcp\Server\Capability\* (Attribute, Completion, Discovery, Formatter, Logger, Registry, Tool, plus Registry and RegistryInterface)
    • Mcp\Event\* => Mcp\Server\Event\*
    • Mcp\JsonRpc\MessageFactory => Mcp\Schema\MessageFactory
    • Mcp\Server\Stateless\RequestMeta => Mcp\Schema\RequestMeta
  • [BC Break] Distribute Mcp\Exception\* across the three namespaces.
    • Mcp\Exception\{ExceptionInterface,InvalidArgumentException,LogicException,RuntimeException} => the same names under Mcp\Schema\Exception\, Mcp\Client\Exception\ and Mcp\Server\Exception\ — pick the one matching the package you catch around
    • Mcp\Exception\Exception => Mcp\Client\Exception\Exception and Mcp\Server\Exception\Exception
    • Mcp\Exception\{InvalidInputMessageException,MissingRequestMetaException} => Mcp\Schema\Exception\*
    • Mcp\Exception\{ConnectionException,ElicitationException,RequestCancelledException,RequestException,RootsException,SamplingException,TimeoutException} => Mcp\Client\Exception\*
    • Mcp\Exception\{BadMethodCallException,ClientException,ConfigurationException,ContainerException,InvalidCursorException,MissingRequiredClientCapabilityException,NotFoundExceptionInterface,PromptGetException,PromptNotFoundException,RegistryException,RequestStateException,ResourceNotFoundException,ResourceReadException,ServiceNotFoundException,SessionLockException,SessionLockTimeoutException,SessionStoreException,ToolCallException,ToolNotFoundException} => Mcp\Server\Exception\*
    • Mcp\Exception\HandlerNotFoundException is removed; it was unused.
    • Mcp\Server\Exception\ExceptionInterface and Mcp\Client\Exception\ExceptionInterface extend Mcp\Schema\Exception\ExceptionInterface, so catching the latter still catches any SDK exception.
    • The named exceptions extend their package's RuntimeException/InvalidArgumentException instead of the global ones, so catch (Mcp\Server\Exception\RuntimeException) reaches ToolCallException, PromptGetException and friends.
  • [BC Break] Move ExtensionInterface::getRequestHandlers() to the new Mcp\Server\Extension\ServerExtensionInterface, so Mcp\Schema does not reference Mcp\Server. AbstractExtension no longer defines it. An extension that serves its methods must implement the new interface, or Builder::enableExtension() does not register its handlers.

General

  • [BC Break] Require PHP 8.2 or higher, as PHP 8.1 reached its end of life.
  • [BC Break] Remove JSON-RPC batch support, as MCP dropped batching in 2025-06-18. The server refuses a JSON array with -32600, and HTTP status 400, on every revision, including 2025-03-26, which requires batches and which the server still negotiates. The client drops one with a warning.
  • [BC Break] Refuse OAuth URLs, in the server and the client, whose host is 0.0.0.0, ::, an IPv4 address within IPv6 or an IPv4 address in a non-standard form (e.g. 127.1), or that hold percent-encoding or non-ASCII characters (give an internationalized name in punycode). In the server, this applies to the issuer, the jwks_uri and the resource.
  • [BC Break] Require phpdocumentor/reflection-docblock ^6.0, with phpdocumentor/type-resolver ^2.0 and phpstan/phpdoc-parser ^2.0: older versions cannot parse types like non-empty-array<T>, and the SDK silently ignored such a @param. Require psr/container ^1.1, as Container is not compatible with 1.0.
  • ext-fileinfo is optional: without it, creating content from a file without a MIME type throws a LogicException.

Server

  • Sessions
    • [BC Break] Serve handshake-era clients over Streamable HTTP without sessions unless Builder::setSession() is called, instead of falling back to an InMemorySessionStore that PHP-FPM and php -S lose between requests. initialize is answered without Mcp-Session-Id, later requests run on an EphemeralSessionInterface that is never stored, and GET and DELETE get 405, so a scaled-out server needs no shared session store or lock. The protocol version comes from the MCP-Protocol-Version header. Stdio and the 2026-07-28 era are not affected. Without a session, requests to the client (elicitation, sampling, roots), Protocol::sendRequest(), Protocol::sendNotification() and saving the session throw a SessionRequiredException, answered with -32603 if a handler does not catch it. Input-required results (unless withoutInputRequiredShim() is used), resources/subscribe, resources/unsubscribe and logging/setLevel get -32603, initialize offers neither resource subscriptions nor logging, log messages are dropped and the client capability checks of ClientGateway return false. Keep sessions with e.g. setSession(new InMemorySessionStore()) in a long-running process.
    • [BC Break] Bind handshake-era sessions to the principal that opened them: AccessToken::getPrincipal(), or the StreamableHttpTransport::PRINCIPAL_ATTRIBUTE request attribute when set. A request of another principal, or to a session opened before the upgrade, gets 404. Protocol::processInput(), the transports' handleMessage(), handleSessionEnd(), handlePostRequest() and handleDeleteRequest(), and the onMessage() and onSessionEnd() listeners take a ?string $principal as last argument.
    • [BC Break] Add SessionInterface::isUnreadable(), which a custom session implements. A session the store holds without attributes, because a handler cleared it or its data is corrupt, gets 404 so the client opens a new one; only a session the store fails to return gets 503. FileSessionStore::exists() no longer reports a zero-byte file.
    • [BC Break] Answer a DELETE of an unknown or ended session with 404 instead of 200, as the spec requires: Protocol::destroySession(), BaseTransport::handleSessionEnd() and the listener of TransportInterface::onSessionEnd() return false for it. A listener that returns nothing keeps the 200.
    • [BC Break] Answer malformed JSON and an initialize sent with a session id with HTTP 400, and a failure before the session is checked with 500, instead of 200. Such an answer no longer carries, or removes, the messages queued for the session in Mcp-Session-Id.
    • Add Psr6SessionStore and Psr6NotificationBus, the PSR-6 counterparts of Psr16SessionStore and Psr16NotificationBus. Builder::setDiscovery() also accepts a PSR-6 pool as $cache.

... (truncated)

Changelog

Sourced from mcp/sdk's changelog.

0.10.0

TL;DR

  • The SDK is split into the Mcp\Schema, Mcp\Client and Mcp\Server namespaces, ahead of separate packages: most imports change
  • PHP 8.2 or higher is required, and JSON-RPC batches are gone
  • The client authorizes with OAuth: authorization code, client credentials, private_key_jwt and experimental cross-app access
  • Handshake-era servers over HTTP run without sessions unless Builder::setSession() is called, and sessions belong to the principal that opened them
  • Request handlers can run under an event loop (Revolt, ReactPHP) with the opt-in Builder::setFiberScheduler(), and stream their responses
  • Tool arguments keep their JSON types, and arguments that don't fit are answered with -32602
  • stdio works on Windows, in the server and the client

Namespaces

  • [BC Break] Split the root namespace into Mcp\Schema, Mcp\Client and Mcp\Server to prepare slicing them into separate packages; update your imports. Mcp\Schema depends on nothing, Mcp\Client and Mcp\Server depend on Mcp\Schema only — enforced by Deptrac (make deptrac).
    • Mcp\Server => Mcp\Server\Server
    • Mcp\Client => Mcp\Client\Client
    • Mcp\Capability\* => Mcp\Server\Capability\* (Attribute, Completion, Discovery, Formatter, Logger, Registry, Tool, plus Registry and RegistryInterface)
    • Mcp\Event\* => Mcp\Server\Event\*
    • Mcp\JsonRpc\MessageFactory => Mcp\Schema\MessageFactory
    • Mcp\Server\Stateless\RequestMeta => Mcp\Schema\RequestMeta
  • [BC Break] Distribute Mcp\Exception\* across the three namespaces.
    • Mcp\Exception\{ExceptionInterface,InvalidArgumentException,LogicException,RuntimeException} => the same names under Mcp\Schema\Exception\, Mcp\Client\Exception\ and Mcp\Server\Exception\ — pick the one matching the package you catch around
    • Mcp\Exception\Exception => Mcp\Client\Exception\Exception and Mcp\Server\Exception\Exception
    • Mcp\Exception\{InvalidInputMessageException,MissingRequestMetaException} => Mcp\Schema\Exception\*
    • Mcp\Exception\{ConnectionException,ElicitationException,RequestCancelledException,RequestException,RootsException,SamplingException,TimeoutException} => Mcp\Client\Exception\*
    • Mcp\Exception\{BadMethodCallException,ClientException,ConfigurationException,ContainerException,InvalidCursorException,MissingRequiredClientCapabilityException,NotFoundExceptionInterface,PromptGetException,PromptNotFoundException,RegistryException,RequestStateException,ResourceNotFoundException,ResourceReadException,ServiceNotFoundException,SessionLockException,SessionLockTimeoutException,SessionStoreException,ToolCallException,ToolNotFoundException} => Mcp\Server\Exception\*
    • Mcp\Exception\HandlerNotFoundException is removed; it was unused.
    • Mcp\Server\Exception\ExceptionInterface and Mcp\Client\Exception\ExceptionInterface extend Mcp\Schema\Exception\ExceptionInterface, so catching the latter still catches any SDK exception.
    • The named exceptions extend their package's RuntimeException/InvalidArgumentException instead of the global ones, so catch (Mcp\Server\Exception\RuntimeException) reaches ToolCallException, PromptGetException and friends.
  • [BC Break] Move ExtensionInterface::getRequestHandlers() to the new Mcp\Server\Extension\ServerExtensionInterface, so Mcp\Schema does not reference Mcp\Server. AbstractExtension no longer defines it. An extension that serves its methods must implement the new interface, or Builder::enableExtension() does not register its handlers.

General

  • [BC Break] Require PHP 8.2 or higher, as PHP 8.1 reached its end of life.
  • [BC Break] Remove JSON-RPC batch support, as MCP dropped batching in 2025-06-18. The server refuses a JSON array with -32600, and HTTP status 400, on every revision, including 2025-03-26, which requires batches and which the server still negotiates. The client drops one with a warning.
  • [BC Break] Refuse OAuth URLs, in the server and the client, whose host is 0.0.0.0, ::, an IPv4 address within IPv6 or an IPv4 address in a non-standard form (e.g. 127.1), or that hold percent-encoding or non-ASCII characters (give an internationalized name in punycode). In the server, this applies to the issuer, the jwks_uri and the resource.
  • [BC Break] Require phpdocumentor/reflection-docblock ^6.0, with phpdocumentor/type-resolver ^2.0 and phpstan/phpdoc-parser ^2.0: older versions cannot parse types like non-empty-array<T>, and the SDK silently ignored such a @param. Require psr/container ^1.1, as Container is not compatible with 1.0.
  • ext-fileinfo is optional: without it, creating content from a file without a MIME type throws a LogicException.

Server

  • Sessions
    • [BC Break] Serve handshake-era clients over Streamable HTTP without sessions unless Builder::setSession() is called, instead of falling back to an InMemorySessionStore that PHP-FPM and php -S lose between requests. initialize is answered without Mcp-Session-Id, later requests run on an EphemeralSessionInterface that is never stored, and GET and DELETE get 405, so a scaled-out server needs no shared session store or lock. The protocol version comes from the MCP-Protocol-Version header. Stdio and the 2026-07-28 era are not affected. Without a session, requests to the client (elicitation, sampling, roots), Protocol::sendRequest(), Protocol::sendNotification() and saving the session throw a SessionRequiredException, answered with -32603 if a handler does not catch it. Input-required results (unless withoutInputRequiredShim() is used), resources/subscribe, resources/unsubscribe and logging/setLevel get -32603, initialize offers neither resource subscriptions nor logging, log messages are dropped and the client capability checks of ClientGateway return false. Keep sessions with e.g. setSession(new InMemorySessionStore()) in a long-running process.
    • [BC Break] Bind handshake-era sessions to the principal that opened them: AccessToken::getPrincipal(), or the StreamableHttpTransport::PRINCIPAL_ATTRIBUTE request attribute when set. A request of another principal, or to a session opened before the upgrade, gets 404. Protocol::processInput(), the transports' handleMessage(), handleSessionEnd(), handlePostRequest() and handleDeleteRequest(), and the onMessage() and onSessionEnd() listeners take a ?string $principal as last argument.
    • [BC Break] Add SessionInterface::isUnreadable(), which a custom session implements. A session the store holds without attributes, because a handler cleared it or its data is corrupt, gets 404 so the client opens a new one; only a session the store fails to return gets 503. FileSessionStore::exists() no longer reports a zero-byte file.
    • [BC Break] Answer a DELETE of an unknown or ended session with 404 instead of 200, as the spec requires: Protocol::destroySession(), BaseTransport::handleSessionEnd() and the listener of TransportInterface::onSessionEnd() return false for it. A listener that returns nothing keeps the 200.
    • [BC Break] Answer malformed JSON and an initialize sent with a session id with HTTP 400, and a failure before the session is checked with 500, instead of 200. Such an answer no longer carries, or removes, the messages queued for the session in Mcp-Session-Id.
    • Add Psr6SessionStore and Psr6NotificationBus, the PSR-6 counterparts of Psr16SessionStore and Psr16NotificationBus. Builder::setDiscovery() also accepts a PSR-6 pool as $cache.

... (truncated)

Commits
  • 5701e69 [Docs] Recommend persistent Redis connections for sessions on PHP-FPM (#730)
  • 9e0f6c9 [Docs] Condense and group the 0.10.0 changelog (#728)
  • dcc804f [CI] Drop stale tools-list-gate entry from 2026-07-28 conformance baseline (#...
  • 0aec843 Prepare package slicing by strict namespace refactoring into Client, Schema, ...
  • f236a9f [Client] Close the remaining OAuth and redirect gaps before 0.10.0 (#727)
  • da5d0d7 [Client] Support completing OAuth authorization in a later request (#660)
  • bfc40f5 [Server] Give FileSessionStore a time budget for replacing a held session fil...
  • 90670d1 Make ext-fileinfo optional and drop composer suggest (#724)
  • e2f4b97 [Client] Keep a client another worker registered when dropping a refused one ...
  • b104297 Drop PHP 8.1 support (#723)
  • Additional commits viewable in compare view

Dependabot compatibility score

Dependabot will resolve any conflicts with this PR as long as you don't alter it yourself. You can also trigger a rebase manually by commenting @dependabot rebase.


Dependabot commands and options

You can trigger Dependabot actions by commenting on this PR:

  • @dependabot rebase will rebase this PR
  • @dependabot recreate will recreate this PR, overwriting any edits that have been made to it
  • @dependabot show <dependency name> ignore conditions will show all of the ignore conditions of the specified dependency
  • @dependabot ignore this major version will close this PR and stop Dependabot creating any more for this major version (unless you reopen the PR or upgrade to it yourself)
  • @dependabot ignore this minor version will close this PR and stop Dependabot creating any more for this minor version (unless you reopen the PR or upgrade to it yourself)
  • @dependabot ignore this dependency will close this PR and stop Dependabot creating any more for this dependency (unless you reopen the PR or upgrade to it yourself)

Bumps [mcp/sdk](https://github.com/modelcontextprotocol/php-sdk) from 0.9.0 to 0.10.0.
- [Release notes](https://github.com/modelcontextprotocol/php-sdk/releases)
- [Changelog](https://github.com/modelcontextprotocol/php-sdk/blob/main/CHANGELOG.md)
- [Commits](modelcontextprotocol/php-sdk@v0.9.0...v0.10.0)

---
updated-dependencies:
- dependency-name: mcp/sdk
  dependency-version: 0.10.0
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
@dependabot dependabot Bot added dependencies Pull requests that update a dependency file PHP Pull requests that update Php code labels Nov 18, 2026
@coderabbitai

coderabbitai Bot commented Nov 18, 2026

Copy link
Copy Markdown

Important

Review skipped

Bot user detected.

To trigger a single review, invoke the @coderabbitai review command.

Run configuration

  • Source mode: Auto
  • Repository: Unavailable
  • Branch: Unavailable
  • File: No configuration file from this repository applied
  • Commit: Unavailable
  • Layers: defaults
  • Review profile: CHILL
  • Plan: Advanced
  • Run ID: fb104945-2001-44fe-b19c-179c663427f9

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • Trigger review
  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

Share

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

dependencies Pull requests that update a dependency file PHP Pull requests that update Php code

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants