1: <?php
2:
3: declare(strict_types=1);
4:
5: /**
6: * This file is part of the Nexus MCP SDK package.
7: *
8: * (c) 2026 John Paul E. Balandan, CPA <paulbalandan@gmail.com>
9: *
10: * For the full copyright and license information, please view
11: * the LICENSE file that was distributed with this source code.
12: */
13:
14: namespace Nexus\Mcp\Server\Exception;
15:
16: use Nexus\Mcp\Core\Exception\McpExceptionInterface;
17:
18: /**
19: * Thrown when a built-in handler is replaced for a method the MCP specification does not reserve.
20: */
21: final class UnreservedMethodException extends \LogicException implements McpExceptionInterface
22: {
23: public function __construct(string $method, bool $isNotification = false)
24: {
25: parent::__construct(\sprintf(
26: '%s method "%s" is not reserved by the MCP specification. Use %s() to register a vendor extension.',
27: $isNotification ? 'Notification' : 'Request',
28: $method,
29: $isNotification ? 'addNotificationHandler' : 'addRequestHandler',
30: ));
31: }
32: }
33: